home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / te2_110c.arc / TE2.DOC < prev    next >
Text File  |  1991-04-02  |  147KB  |  3,199 lines
  1.                         Documentation for Oberon Terminal Emulator/2
  2.                                                       Version 1.10.c
  3.                                                    Shareware Version
  4.  
  5.                                                      Oberon Software
  6.                                                518 Blue Earth Street
  7.                                                    Mankato, MN 56001
  8.  
  9.                                            Voice Phone: 507/388-7001
  10.                                                    BBS: 507/388-1154
  11.                                                    FAX: 507/388-3099
  12.                                            MCI Mail: oberon/413-5847
  13.                                                GEnie Mail: B.FLOWERS
  14.                                                      CIS: 72510,3500
  15.  
  16.                                                        April 2, 1991
  17.  
  18.   -------------------------------------------------------------
  19.  
  20.  Copyright 1991, Oberon Software, Mankato, MN - All Rights Reserved
  21.  
  22.   -------------------------------------------------------------
  23.  
  24.                            Contents
  25.  
  26.         Forward
  27.   I.    Restrictions
  28.   II.   System Requirements
  29.   IV.   About TE/2 - Overview
  30.   V.    Installation
  31.   VI.   Starting TE/2
  32.         A. From the OS/2 command line
  33.         B. From the Presentation Manager
  34.   VII.  About TE/2 - Detailed
  35.         A. Terminal Mode
  36.         B. The Dialing Directory
  37.         C. Dialer
  38.         D. Chat Mode
  39.         E. The Scroll Back Buffer
  40.         F. Protocol Status Display
  41.   VIII. Customization
  42.         A. TE2.INI
  43.         B. TE/2 Command Line
  44.         C. Starting TE/2 from Presentation Manager
  45.         D. TE2.XEX
  46.         E. TE2.FNK
  47.         F. TE2INP.XLT and TE2OUT.XLT
  48.   IX.   Registering TE/2
  49.   X.    Disclaimer
  50.  
  51.  
  52.  
  53.   -------------------------------------------------------------
  54.  
  55.                     Forward to Version 1.10.b
  56.                         15 August, 1990
  57.  
  58.     Version 1.10.a was the first official release of TE/2 as a
  59.   shareware product.  Several earlier versions were available
  60.   previously and were referred to as "beta" test versions.  I
  61.   would like to thank everyone who, after using one or another
  62.   of these "pre-release" versions contacted me with problem
  63.   reports, suggestions, compliments, and/or criticisms.  There were
  64.   quite a few of you and, having proved that you are a vocal lot,
  65.   I quite expect to continue receiving your excellent feedback.
  66.   This I look forward to, it can only help to make TE/2 a better
  67.   program.
  68.  
  69.     During the last month or two, during the final beta test cycle,
  70.   several people have donated a large share of their time helping
  71.   to prepare for this version of TE/2.  Special thanks go out to
  72.   Jim Gilliland, Jon Saxton, Mike Smedley, and Chacko Neroth for
  73.   all of their invaluable help.  Thanks to Chuck Gilmore for much
  74.   good advice and moral support.  Thanks to Phil Jurgenson for help
  75.   with the English language.
  76.  
  77.  
  78.  
  79.                    Forward to Version 1.10.c
  80.                          31 March, 1991
  81.  
  82.     It seems that I have a great many more people to thank with this
  83.   release of TE/2.  I speak of all the people out there in the
  84.   U.S., Canada, Europe, and Australia who have used and registered
  85.   version 1.10.b.  It has been your support, in more than just a
  86.   monetary sense, that has really made TE/2 a living growing thing.
  87.   Of course, without adequate financial support, no product can hope
  88.   to survive and I am very grateful for your support in that arena.
  89.   But also, I am grateful for the personal feedback. It helps a
  90.   developer to maintain a sense of accomplishment and, more often than
  91.   not, humility.
  92.  
  93.     Thanks to everyone who has helped directly or indirectly with this
  94.   release of TE/2: testers, advisors, friends and family.  Special
  95.   thanks for the continuing assistance of everyone mentioned in the
  96.   earlier dedication and also to Pete and Bobbie Norloff, Chris Laforet,
  97.   Ron Hendricks, Robbie Faust, Rell Ambrose, Matt Johnson, and to IBM
  98.   for providing a wonderful Developers Assistance Program.
  99.  
  100.  
  101.   -------------------------------------------------------------
  102.  
  103.  
  104. I. Restrictions
  105.  
  106.     This version of TE/2 is supplied for personal, private use.
  107.   Feel free to distribute TE/2 given these restrictions:
  108.  
  109.    o  the program shall be supplied in its original, unmodified
  110.       form, which includes this documentation and all accompanying
  111.       support files;
  112.  
  113.    o  no fee is charged;
  114.  
  115.    o  use for profit without a license is prohibited;
  116.  
  117.    o  the program may not be included or bundled with other
  118.       goods or services. Exceptions may be granted upon written
  119.       request only.
  120.  
  121.  
  122.     If you are using TE/2 and find it of value, you are expected to
  123.   become a registered user.  In exchange for registration you will
  124.   receive an enhanced version of TE/2 containing, among other things,
  125.   TE/2's Script Language interpreter.  You will also receive printed
  126.   documentation for TE/2, one free version upgrade when the next
  127.   version becomes available, and automatic notification of all future
  128.   releases.
  129.  
  130.     For information on registering, please see the file ORDER.FRM
  131.   distributed with the shareware archive file.  If for some reason
  132.   this file is not available, please write, call, or fax Oberon
  133.   Software for information.  Addresses and phone numbers appear at
  134.   the beginning and the end of this file.
  135.  
  136.     For use by corporations and other institutions, please  contact
  137.   the Oberon Software for a licensing arrangement.
  138.  
  139.  
  140.  
  141.   -------------------------------------------------------------
  142.  
  143.  
  144. II. System Requirements
  145.  
  146.     TE/2 is written for the IBM PC/AT, IBM PS/2, or any compatible
  147.   computer that can run MS OS/2 or IBM OS/2.  TE/2 will run in OS/2
  148.   Protected Mode only and may be run from either a full screen OS/2
  149.   session or on a Presentation Manager VIO window.
  150.  
  151.     TE/2 requires OS/2 version 1.1 or later.
  152.  
  153.     In addition, a modem or other asynchronous communications device
  154.   will be necessary for the operation of TE/2.
  155.  
  156.  
  157.   -------------------------------------------------------------
  158.  
  159.  
  160. IV.   About TE/2 - Overview
  161.  
  162.     TE/2 is a communications program for OS/2 protected mode.  It is
  163.   a full screen application (not a Presentation Manager application)
  164.   and will run in either a full screen session or a VIO windowed
  165.   session.  Because TE/2 is multi-threaded, it cannot be made into a
  166.   bound application.
  167.  
  168.     The shareware version of TE/2 is a fully functional communications
  169.   program.  There is no "expiration date" on which it self-destructs
  170.   or otherwise becomes inoperable.  The features which this version
  171.   has in common with the full, registered version are complete and
  172.   not "crippled" in any way.  These features include:
  173.  
  174.     o  Five terminal emulation modes: raw TTY mode, standard ANSI-BBS
  175.        mode, an extended ANSI mode called ANSI-TE/2, VT100, and IBM
  176.        3101 emulation mode.
  177.  
  178.     o  Six upload/download protocols: standard Xmodem-CRC with
  179.        Checksum fall-back, XModem-1K which supports 1024 byte packets
  180.        and automatic fall-back to standard XModem, YModem batch
  181.        protocol, YModem-G variant of the YModem protocol for MNP
  182.        modems, ZModem batch protocol, and straight ASCII text file
  183.        uploads and log file capture ability for text file "downloads".
  184.  
  185.     o  Multiple 200 entry dialing directories.
  186.  
  187.     o  Default line parameters, terminal emulation, and transfer
  188.        protocol assignable to each directory entry.
  189.  
  190.     o  Time and date of last connection and number of connections to
  191.        date saved for each directory entry.
  192.  
  193.     o  Auto redialing, manual dialing, and round-robin "queue-dialing".
  194.  
  195.     o  Split screen "Chat" mode with access to nearly all of the
  196.        program functions normally available in standard terminal mode.
  197.  
  198.     o  Unlimited number of user definable external programs with very
  199.        robust command line handling.  External programs may be
  200.        executed in the foreground or background, as a child process or
  201.        as a separate session.
  202.  
  203.     o  All 48 function keys fully programmable as text macros.
  204.  
  205.     o  Shell to operating system.
  206.  
  207.     o  "Scroll-Back" redisplay buffer, user definable to nearly any
  208.        desired size.  Scroll back buffer may be searched for text and
  209.        the entire buffer or a subset may be written to disk.
  210.  
  211.  
  212.  
  213.   -------------------------------------------------------------
  214.  
  215.  
  216. V.    Installation
  217.  
  218.     You may place TE/2's files nearly anywhere you want on your
  219.   hard disk with only a few restrictions:
  220.  
  221.       1. The file COMMPAK2.DLL must be placed in a directory referred
  222.          to in your LIBPATH setting from your CONFIG.SYS file.  If
  223.          you are not sure what this setting is, please look into your
  224.          CONFIG.SYS file using a text editor such as the OS/2 system
  225.          editor.  Look for a line that begins "LIBPATH=".  It will
  226.          have a directory name, or list of directory names separated
  227.          by semicolons, following the equal sign.  COMMPAK2.DLL must
  228.          be placed into one of these directories.
  229.  
  230.          ADVANCED USERS:  It is very convenient to place "." in the
  231.          LIBPATH. I.e., "LIBPATH=.;C:\OS2\DLL;" so that the current
  232.          directory is always searched first for a DLL.  This way an
  233.          application like TE/2 may be kept together in a directory
  234.          with its attendant DLL(s).
  235.  
  236.       2. It is recommended that you place all the rest of the files
  237.          together in a single directory, perhaps creating a "TE2"
  238.          directory specifically for this purpose.  This is not
  239.          a necessary procedure but it certainly aids in keeping track
  240.          of TE/2 and its support files.
  241.  
  242.       3. If you want to be able to execute TE/2 from any directory on
  243.          your disk, you should make sure that the directory you have
  244.          chosen for TE/2 is referred to in your PATH environment
  245.          setting.  TE/2 will be able to find its support files as
  246.          long as they are in the same directory as TE2.EXE or
  247.          otherwise somewhere along the PATH.
  248.  
  249.     Several of the support files will need to be customized for your
  250.    system and/or personal preferences.  The most important of these is
  251.   the file TE2.INI.  The use of this file is covered more completely
  252.   below in the section on Customization. However, in order to get "up
  253.   and running" it may be necessary to alter a couple of things in
  254.   this file right now.
  255.  
  256.     TE2.INI is a flat ASCII text file; you may use the text editor of
  257.   your choice to view or alter this file.  For our purposes here we
  258.   will assume that you are using the OS/2 system editor.  Load the
  259.   file into the editor either by typing "e te2.ini" at the OS/2
  260.   command line prompt or by invoking the editor from the Presentation
  261.   Manager and loading the file via the editor's "File.." menu.
  262.  
  263.     Each line in the TE2.INI file contains a keyword followed by a
  264.   value (or it is a comment line beginning with a semicolon).  You
  265.   should look for the following keywords. These are the things you are
  266.   most likely to need to change:
  267.  
  268.     Port        If your modem is attached to the COM1 port you do not
  269.                 need to do anything, leave the line as it is.  If your
  270.                 modem is attached to COM2 or COM3, change the number
  271.                 "1" on this line to "2" or "3" as appropriate.
  272.                 If your communications device is not COM1, COM2, COM3,
  273.                 et cetera, you must change the "Device" statement.
  274.  
  275.     Device      Alter this statement only if you need to do so as
  276.                 mentioned in the above paragraph on the "Port"
  277.                 statement.  If your communications device is not named
  278.                 COMx (where "x" is a number from 1 to 8) you must
  279.                 "un-comment" this line (remove the leading semicolon)
  280.                 and replace the "com1" that follows the keyword with
  281.                 the name of your comm device.  The "Device" statement
  282.                 will supersede the "Port" statement.
  283.  
  284.     Baud        This determines the baud rate at which TE/2 will
  285.                 begin operations.  It is set to 2400 by default.  If
  286.                 your modem is not capable of 2400 baud, you should
  287.                 replace the number "2400" on this line with the
  288.                 highest baud rate your modem is capable of.  Likewise,
  289.                 if you have a high speed modem, you will most likely
  290.                 want to increase this number to your desired baud
  291.                 rate.
  292.  
  293.     If you do not have a Hayes compatible modem, you will need to
  294.   refer to the "Customization" section below for information on
  295.   further modifying the settings in TE2.INI.  Otherwise, this should
  296.   be sufficient for you to start up TE/2.
  297.  
  298.  
  299.  
  300.   -------------------------------------------------------------
  301.  
  302.  
  303. VI.   Starting TE/2
  304.  
  305.     A. From the OS/2 command line
  306.  
  307.     Once you've installed the various files as outlined in the
  308.   section on Installation, you are ready to try running TE/2.  From
  309.   the OS/2 command line this is as easy as typing "TE2" at the system
  310.   prompt.  The first thing you should see on the screen is the TE/2
  311.   logo display.  If any errors were encountered while TE/2 was
  312.   reading its initialization file a message or messages will be
  313.   printed on the screen before the logo display.  If you receive any
  314.   such error messages you should locate the line referred to in the
  315.   message, and correct the situation.  Refer to the section on
  316.   Customization below to find a discussion of the keyword in question.
  317.   The logo display will remain on the screen for several seconds as
  318.   TE/2 initializes, after which you may strike any key to remove the
  319.   logo display, or simply wait several more seconds for it to remove
  320.   itself.
  321.  
  322.     The second screen is a shareware notice.  If this your the first
  323.   time running TE/2 you should read through this screen.  Afterwards,
  324.   you may strike any key to enter TE/2 terminal mode or press the
  325.   ESCape key to exit TE/2 at this point.
  326.  
  327.  
  328.     B. From the Presentation Manager
  329.  
  330.     You should refer to your OS/2 documentation for the procedure to
  331.   follow for installing applications into the Presentation Manager.
  332.   This process differs among the various versions of OS/2 and will
  333.   not be covered here in detail.  There are several things to
  334.   consider which are common to all versions however.
  335.  
  336.       1. The Icon File
  337.  
  338.       There are two icon files distributed with TE/2.  There names
  339.     are TE2_11.ICO and TE2_12.ICO and they are for use with OS/2
  340.     version 1.1 and 1.2 respectively.  You should copy or rename the
  341.     appropriate icon file as TE2.ICO and make sure that it is in
  342.     the same directory as TE2.EXE.
  343.  
  344.  
  345.       2. Properties
  346.  
  347.       When OS/2 asks if the program should be run in a full screen
  348.     session or in a Presentation Manager Window, you may choose
  349.     either of these options.  DO NOT indicate to the Presentation
  350.     Manager that TE/2 is a Presentation Manager Application or a
  351.     DOS Mode Application even if it will let you (it shouldn't).
  352.     For maximum speed of operations you should indicate that TE/2
  353.     should be run in a full screen session.  It may even be
  354.     convenient to install two startup entries for TE/2, one for a
  355.     full screen session and another for a Presentation Manager
  356.     Window.  You can then chose the one which is more appropriate
  357.     for the task at hand.
  358.  
  359.       3. Colors
  360.  
  361.       If you run TE/2 in a Presentation Manager Window you may not
  362.     be satisfied with the default color setup.  These may be modified
  363.     in your TE2.INI file. See the section on Customization for
  364.     information on setting the TE/2 color attributes.  You may even
  365.     specify an alternate initialization file for TE/2 when it is to
  366.     be run in windowed mode.  To do this you should make copy of the
  367.     TE2.INI either in the same directory with a different name or in
  368.     another directory (with or without a different name).  Referring
  369.     to the Customization section, make the changes to your alternate
  370.     initialization file.  You must also change the section in the
  371.     Presentation Manager installation for TE/2 as to Command Line
  372.     Parameters;  add the command line "-f<filename>" where
  373.     "<filename>" is the name of your alternate initialization file.
  374.  
  375.  
  376.   -------------------------------------------------------------
  377.  
  378.  
  379. VII.  About TE/2 - Detailed
  380.  
  381.       A. Terminal Mode
  382.  
  383.     TE/2 enters terminal mode as soon as it has completed its startup
  384.   procedures.  In terminal mode the top portion of the screen will be
  385.   mainly blank when you first enter; you may see one or two lines of
  386.   information resulting from initializing the modem.
  387.  
  388.     The lower ten lines of the screen contain a menu of available
  389.   commands along with the keystroke used to invoke the command. 
  390.   Let's examine these functions one by one.  The behavior of many
  391.   of these commands may be altered in the TE2.INI file.  You should
  392.   refer to the section on Customization for information on doing so.
  393.   Here we will discuss the default behavior of each and note as to
  394.   how they may be modified.
  395.  
  396.  
  397. =============================================================================
  398. Alt-A Terminal Emulation Alt-J User Programs      Alt-S Snap Shot
  399. Alt-B Send Break         Alt-K Keyboard Macros    Alt-T Logfile Toggle
  400. Alt-C Clear Term Screen  Alt-L Logfile Open/Close Alt-U Upload
  401. Alt-D Dial Directory     Alt-M Manual Dial        Alt-V LF after CR
  402. Alt-E Toggle local Echo  Alt-N Download           Alt-W Scroll Back
  403. Alt-F                    Alt-O OS/2 shell         Alt-X Exit to OS/2
  404. Alt-G Chat Mode          Alt-P Parameters         Alt-Y
  405. Alt-H Hangup             Alt-Q Queue Dial         Alt-Z Toggle Menu
  406. Alt-I Information        Alt-R Redial            -- TE/2 Terminal Emulator --
  407.  
  408.  
  409.                                 Figure AA.
  410.                            Terminal Screen Menu
  411.  
  412.  
  413.  
  414.       Alt-A Terminal Emulation
  415.       ========================
  416.  
  417.         You are presented with a menu listing the available terminal
  418.       emulation modes.  The current emulation mode will be the
  419.       default selection on the menu; at startup this will be
  420.       ANSI-TE/2 unless this has been changed in your initialization
  421.       file.
  422.  
  423.         The various emulation modes are listed here with a brief
  424.       overview of each.
  425.  
  426.         TTY
  427.           "Raw" terminal mode, no character translation is performed
  428.         except on carriage return, line feed, backspace, tab, and
  429.         bell characters.  There are no key reassignments made.
  430.  
  431.         ANSI-BBS
  432.           Standard ANSI terminal mode as expected by most Bulletin
  433.         Board systems.  All color attribute commands, cursor
  434.         positioning commands, and device status report commands
  435.         are supported.  Those ANSI command which change the video
  436.         mode are NOT supported.  The cursor keys, both on the numeric
  437.         keypad with NumLock off and the dedicated gray cursor keypad
  438.         are reassigned to send the standard ANSI keypad values.
  439.  
  440.         ANSI-TE/2
  441.           This is a slightly extended ANSI emulation mode.  It
  442.         supports everything that the ANSI-BBS mode does plus several
  443.         extended commands.
  444.  
  445.         VT100
  446.           Supports most VT-100 command codes.  The cursor keypads
  447.         are remapped and may be reprogrammed by the host.  VT100 mode
  448.         will respond to ENQ characters sent from the host if the
  449.         EnqReply is defined in the initialization file.  Function
  450.         keys F1 - F4 will behave like the PF keys on the VT100 unless
  451.         you have redefined them (see the section on TE2.FNK below).
  452.         When in VT100 mode, the '*' key on the numeric keypad will
  453.         act as if it were the COMMA key on the VT100 numeric keypad.
  454.         Some VT102 functions are also supported.  There is one VT100
  455.         specific setting in the TE2.INI file: EnqReply.  This may
  456.         be set to the string which the VT100 emulator will return to
  457.         the host when it encounters the ENQ characters.
  458.  
  459.         3101
  460.           Supports most character (stream) mode 3101 operations.
  461.         Block mode is not supported in this release.  The cursor keys
  462.         and keypad are remapped to emulate the 3101 keyboard and
  463.         function keys F1 - F8 will behave like the PF keys on the
  464.         3101 keyboard unless you have redefined them (see the section
  465.         on TE2.FNK below).  There are several 3101 specific settings
  466.         in the TE2.INI file: AutoNL3101, AutoLF3101, Scroll3101, and
  467.         EndChar3101.  These simulate several of the switch setting
  468.         on the IBM 3101 terminal.  Refer to the Customization section
  469.         elsewhere in this document for further information.
  470.  
  471.  
  472.       Alt-B Send Break
  473.       ================
  474.  
  475.           Transmits a 1000ms break signal.  The duration may be
  476.         changed in the initialization file.
  477.  
  478.  
  479.       Alt-C Clear Term Screen
  480.       =======================
  481.  
  482.           Clears the terminal screen (that portion of the screen
  483.         above the menu) to the current attribute.  Note that this
  484.         color attribute may not be the same as you have defined
  485.         for the terminal screen (default is white on black) if you
  486.         are in an ANSI mode and the remote system has sent the
  487.         appropriate codes to reset the default attribute.
  488.  
  489.           You may alter the operation of the Clear Screen function
  490.         such that it will restore the default attribute before
  491.         clearing the screen via the "ClsReset" setting in the TE2.INI
  492.         file.
  493.  
  494.  
  495.       Alt-D Dial Directory
  496.       ====================
  497.  
  498.           Enter dialing directory mode.  The various features and
  499.         functions of the dialing directory are covered in detail
  500.         in a section below.
  501.  
  502.  
  503.       Alt-E Toggle Local Echo
  504.       =======================
  505.  
  506.           Local echo is OFF by default unless it has been changed in
  507.         the initialization file.  When local echo if ON all
  508.         characters typed at the keyboard are sent to the screen as
  509.         well as transmitted to the communications port.  Most BBS
  510.         systems will automatically echo your characters back to you
  511.         through the phone lines so you will want to leave Local Echo
  512.         turned off or you will see each character appear twice on the
  513.         screen.  Some host systems do not echo your characters, when
  514.         connected to such as system you must turn Local Echo ON in
  515.         order to see what you are typing.
  516.  
  517.           Note: You may set the state of the local echo on an entry
  518.         by entry basis in the dialing directory.
  519.  
  520.  
  521.       Alt-G Chat Mode
  522.       ===============
  523.  
  524.           Enter chat mode.  The various features and functions of
  525.         chat mode are covered in detail in a section below.
  526.  
  527.  
  528.       Alt-H Hangup
  529.       ============
  530.  
  531.           Sends a sequence of commands to the modem which will cause
  532.         any active connection to be severed.  If you are currently
  533.         on-line when you request hangup, TE/2 will ask you for
  534.         verification before proceeding; this behavior may be modified
  535.         in the initialization file so that it will always ask or never
  536.         ask.
  537.  
  538.           The default terminal color attribute is restored after a
  539.         hangup command is issued.
  540.  
  541.           Note: The default action at hangup is to drop the Data
  542.         Terminal Ready signal momentarily before sending the default
  543.         modem hangup command.  You may alter this behavior in the
  544.         initialization file so that DTR is not dropped.  You may also
  545.         modify the modem command string.
  546.  
  547.  
  548.       Alt-I Information
  549.       =================
  550.  
  551.           Presents an informational display of the current values of
  552.         the following settings:
  553.  
  554.            Com Port: Port number/name
  555.                Baud: Baud rate setting
  556.              Parity: Parity setting (None, Even, etc.)
  557.         Word Length: Data Word length (7 or 8)
  558.           Stop Bits: Number of stop bits (1, 1.5, or 2)
  559.           Emulation: Emulation mode (TTY, ANSI-BBS, etc.)
  560.          Local Echo: Local echo setting (True or False)
  561.         LF after CR: CR/CR-LF setting (True or False)
  562.         Line Status: OnLine or OnHook
  563.            Log File: Log file name
  564.          Log Status: Log file status (Open, Closed, or Paused)
  565.             Process: Always "1" in this version of TE/2
  566.  
  567.           The bottom line of the Information display contains the
  568.         current date and time.  The time display is a real-time
  569.         clock.
  570.  
  571.           The current version of TE/2 and of the CommPak/2 Dynamic
  572.         Link Library, and contact information for Oberon Software
  573.         are also displayed at this time.
  574.  
  575.  
  576.       Alt-J User Programs
  577.       ===================
  578.  
  579.           Displays a menu of the user defined external program as set
  580.         forth in the file TE2.XEX.  The default set of these entries
  581.         contains mainly examples which use some standard OS/2
  582.         programs to give you a guide to installing a set of your own.
  583.         For more information on this procedure please refer to the
  584.         section on Customization.
  585.  
  586.           To execute a program on this list, just move the menu
  587.         highlight to the desired line and press ENTER.
  588.  
  589.           You may have more than one set of external programs
  590.         defined.  TE/2 always reads the default set from TE2.XEX
  591.         first however if you type "N" (for "New File") while the
  592.         external programs menu is on screen you will be prompted for
  593.         a new file to load for this menu.
  594.  
  595.  
  596.       Alt-K Keyboard Macros
  597.       =====================
  598.  
  599.           Displays a menu that will allow you to examine and/or alter
  600.         the strings assigned to all 48 function keys (the 12 "Normal"
  601.         function keys, and in conjunction with the Shift, Control,
  602.         and Alt keys).  These assignments define what will be
  603.         transmitted when that key is typed in terminal mode.
  604.  
  605.           The menu contains the following options:
  606.  
  607.                 Regular
  608.                 Shifted
  609.                 Control
  610.                 Alt
  611.                 Save File
  612.                 New File
  613.  
  614.           The first four options on this menu will each invoke a
  615.         dialog wherein the 12 associated function key assignments may
  616.         be viewed.  You may use the up and down cursor keys to move
  617.         about and any of the 12 lines may be edited.  When your
  618.         editing is complete you may type ENTER and the new
  619.         assignments will be in effect or type ESCape to return the
  620.         assignments to what they were before you entered the section.
  621.  
  622.           There are two "special" characters which may be entered
  623.         into a function key assignment.  They are the tilde ("~")
  624.         and the caret ("^") characters.  The tilde will be translated
  625.         into a 0.50 second pause when the string is sent to the modem.
  626.         The caret works in conjunction with the character directly
  627.         following it.  This is your method of embedding control codes
  628.         into the string.  If you need to transmit a carriage return
  629.         character you will need to use the sequence "^M" (pronounced
  630.         "Control-M") to do so.  The carriage return character has the
  631.         ASCII code 13, the "M" is the thirteenth character in the
  632.         alphabet, thus the conversion.  Similarly, the line feed
  633.         character has ASCII code 10 so you would use "^J".  A couple
  634.         less obvious examples would be "^@" to send a NULL (zero)
  635.         character and "^[" to send the ESCape character (ASCII code
  636.         27).  Use "^!" if you need to send an actual "^" character.
  637.  
  638.           In the registered version of TE/2 you may also have a
  639.         function key execute an arbitrary TE/2 Script Language
  640.         command.  Any function key definition which begins with an
  641.         exclamation point will be treated as a command.
  642.  
  643.           Another way to exit this dialog is by typing a function key
  644.         (without the Shift, Control, or Alt key).  This will exit
  645.         both the dialog and the Function Key menu and transmit the
  646.         string associated with that key in the current dialog.
  647.  
  648.           You should be aware that two of the terminal emulations,
  649.         the VT100 and the IBM 3101 will use some of the unshifted
  650.         function keys to emulate their respective keyboards if they
  651.         have not been redefined here.  The VT100 uses keys F1 through
  652.         F4, the 3101 uses F1 through F8.  If you want the emulation
  653.         package to have access to these keys you should not redefine
  654.         them through this facility.
  655.  
  656.  
  657.       Alt-L Logfile Open/Close
  658.       ========================
  659.  
  660.           If there is no log file currently open, you will be
  661.         prompted for the name of a file.  If you don't specify a path
  662.         with the file name, the default log file path specified in
  663.         your initialization file will be added to the beginning of
  664.         the file name (the default log file path is the current
  665.         directory unless you have modified the setting in the
  666.         initialization file, see the section on Customization for
  667.         details).  If the file already exists you will be asked if
  668.         you want to append new data to that file, overwrite the old
  669.         file with the new data, retype the file name, or just cancel
  670.         the whole affair.
  671.  
  672.           All characters that are sent to the terminal screen while
  673.         a log file is open (except for ANSI ESCape codes) will be
  674.         placed into the log file.  This is useful for capturing a
  675.         long stream of text or messages from the remote source so
  676.         that you may look through it later when you are off-line.
  677.  
  678.           If there is a log file currently open, this function will
  679.         close it.
  680.  
  681.  
  682.  
  683.       Alt-M Manual Dial
  684.       =================
  685.  
  686.           Use this function to dial a phone number that is not in
  687.         your dialing directory.  Simply type the number as it should
  688.         be dialed at the prompt.  TE/2 will dial that number, the
  689.         line settings will be whatever is current when Manual Dial
  690.         was invoked.  You may always change the line settings later.
  691.  
  692.  
  693.       Alt-N Download  (Also: Gray PgDn key)
  694.       ==============
  695.  
  696.           This presents you with a menu of choices for which download
  697.         protocol you wish to begin.  The choices available in this
  698.         version of TE/2 are:
  699.  
  700.             XModem
  701.  
  702.               This is a nearly universal protocol in the PC world.
  703.             Though others may be faster, it is almost guaranteed
  704.             that any system you are connected to will support the
  705.             XModem protocol.  When you select XModem from the menu
  706.             you will be asked to supply a file name for the incoming
  707.             file.
  708.  
  709.               There are two different "flavors" of XModem.  The
  710.             difference is in the error detection method employed.
  711.             The older method uses what is called a CheckSum, the
  712.             newer uses a "Cyclical Redundancy Check" (CRC) method.
  713.             You might see these referred to on various systems as
  714.             "XModem" and "XModem-CRC".  TE/2 is able to automatically
  715.             detect which version of XModem the receiving system is
  716.             expecting and will adapt appropriately.  TE/2 will always
  717.             try first to use the more reliable CRC method but will
  718.             "fall back" to CheckSum error detection if necessary.
  719.  
  720.  
  721.             XModem1K
  722.  
  723.               This is exactly like XModem except that XModem1K uses
  724.             a larger block size (1024 bytes as opposed to 128 bytes
  725.             in XModem) and will be slightly faster because of it.
  726.             XModem1K uses the CRC (see notes in XModem above)
  727.             method is error detection.  XModem1K is able to auto-
  728.             matically "fall back" to XModem-CRC if necessary.  When
  729.             you select XModem1K from this menu you will be asked to
  730.             supply a file name for the incoming file.
  731.  
  732.               This protocol might actually be called YModem by some
  733.             systems or communications programs.  This is an
  734.             historical accident that you must be aware of.  These
  735.             systems and programs usually refer to "real" YModem as
  736.             YModem Batch.
  737.  
  738.  
  739.             YModem
  740.  
  741.               YModem is like XModem1K but adds one extra packet of
  742.             information preceding each file it transfers.  This
  743.             packet contains the files name, size, and the time/date
  744.             stamp of the file.  Thus YModem is able to recreate the
  745.             transferred file more exactly than the XModem protocols.
  746.             When you select YModem from this menu you will not be
  747.             asked to supply a file name because this feature of the
  748.             protocol.
  749.  
  750.               YModem is a "batch" protocol.  This means that the
  751.             sending system is able to send several files, one after
  752.             the other, during one YModem session.
  753.  
  754.               Some systems and communications program may call what
  755.             is really XModem1k by the name YModem (see notes in
  756.             XModem1K above) and may call what is really YModem by
  757.             the name YModem Batch.
  758.  
  759.  
  760.             YModem-G
  761.  
  762.               This is exactly like YModem as described above except
  763.             that the protocol makes very little attempt to detect
  764.             errors that occur during the transmission.  It is for
  765.             use between two systems, both of which are using modems
  766.             capable of doing this error detection/correction them-
  767.             selves (such as an MNP modem).  If you are unsure of
  768.             whether your modem has such a feature or whether the
  769.             remote system to which you are connected has such a
  770.             modem, you should probably not attempt to use YModem-G.
  771.             You should check your modem documentation to determine
  772.             whether your modem is capable of hardware error
  773.             correction and, if so, how to enable this feature.
  774.             If you are unsure of the remote source, you should ask
  775.             the system operator or administrator.
  776.  
  777.  
  778.             ZModem
  779.  
  780.               ZModem is an evolutionary step beyond the XModem/YModem
  781.             family of protocols.  It uses a more sophisticated method
  782.             or error detection and correction, is able to transmits
  783.             data packets in one direction on the phone line while
  784.             transmitting verification or error reports in the other,
  785.             and can dynamically reconfigure its own operation during
  786.             a transfer in an attempt to gain the best results for the
  787.             current line connection and other variables.
  788.  
  789.               ZModem was developed by Chuck Foresburg for Omen Tech-
  790.             nologies and is a trademark of theirs.  The source code
  791.             for (a Unix/DOS/VMS version of) ZModem has been placed
  792.             into the public domain and is available for download to
  793.             any interested parties via the Oberon Software User
  794.             Support BBS free of charge.
  795.  
  796.  
  797.             CompuServe B Plus Protocol
  798.  
  799.               Note that CompuServe B Plus protocol is only available
  800.             in the registered version of TE/2.
  801.  
  802.               This protocol does NOT appear on the upload or download
  803.             protocol menus because of the client-server nature of the
  804.             CompuServe Transport Layer.  In order to accomplish a CIS
  805.             B Plus file transfer with CompuServe, you must select CIS
  806.             B Plus as the default file transfer protocol in the dial-
  807.             ing directory entry for CompuServe (see the section on
  808.             the TE/2 Dialing Directory, below for details).  While you
  809.             are on-line with CompuServe, TE/2 will then be in a Compu-
  810.             Serve "mode".  If you then select a B Plus file transfer
  811.             to the CompuServe host, from that point on, the details
  812.             of the file transfer will be handled by CompuServe and
  813.             communicated directly to TE/2 through the protocol.  It
  814.             should be noted that CIS B Plus Protocol does NOT follow
  815.             the rules for Default Download and Upload paths and the
  816.             progress reports in the Protocol Status Display may be
  817.             more esoteric than with the other protocols.
  818.  
  819.  
  820.           As the file transfer progresses, you will be kept abreast of
  821.         its progress via a dialog box.  Refer to the section on the
  822.         "Protocol Status Display" for an explanation of this dialog.
  823.  
  824.  
  825.  
  826.       Alt-O OS/2 shell
  827.       ================
  828.  
  829.           This function will execute a new copy of CMD.EXE as
  830.         a foreground task and allow you to perform a directory
  831.         listing, copy files, or run nearly any program you need
  832.         at a moments notice.  Because of the multitasking nature
  833.         of OS/2 and the Presentation Manager, this function if
  834.         not strictly necessary (as it was in MSDOS) however we
  835.         have found it much quicker and more convenient for many
  836.         simple tasks to use this function rather than
  837.         Alt-ESCaping or clicking to another window.  TE/2's
  838.         current screen contents are saved before the shell is
  839.         executed and restored upon return.
  840.  
  841.           You should NOT however remain the this OS/2 shell for
  842.         long periods of time (or at all) if there is any amount
  843.         of data coming in at the comm port as TE/2's comm port
  844.         handler will work at reduced efficiency during this
  845.         process and data may be lost.
  846.  
  847.           By default, the program executed by this function is
  848.         CMD.EXE which results in an OS/2 command line prompt.
  849.         If you have some other command interpreter, such
  850.         as the Hamilton CShell or Brady Flowers' FSHL program,
  851.         you may optionally configure this function to execute
  852.         any program of your choice.  Please refer to the section
  853.         on Customization for details on how to accomplish this.
  854.         This is not restricted to "shell" programs, the executed
  855.         program could as well be an editor or any other text
  856.         mode application.  However, you should note that there is
  857.         much greater functionality for executing external
  858.         programs in the "User Programs" section (see the section
  859.         with that name above and also under Customization for
  860.         details) so you will probably want to restrict your use
  861.         of this feature to a simple shell program.
  862.  
  863.  
  864.  
  865.       Alt-P Parameters
  866.       ================
  867.  
  868.           This function presents you with a menu allowing you to
  869.         view and optionally alter the current settings for: Port,
  870.         Baud, Parity, Word Length, and Number of Stop Bits.
  871.         The menu is two dimensional, the left and right arrows
  872.         move you between the various parameters while the up and
  873.         down arrows move you between the various possible
  874.         settings for the current parameter.
  875.  
  876.  
  877.                  ┌───────────────────────────────────────┐
  878.                  │         Set Line Parameters           │
  879.                  ├───────────────────────────────────────┤
  880.                  │      Current: COM2,2400,N,8,1         │
  881.                  ├───────────────────────────────────────┤
  882.                  │                                       │
  883.                  │   Port   Baud    Parity  Word  Stop   │
  884.                  │                                       │
  885.                  │   COM1   110     None    7     1      │
  886.                  │   COM2   150     Odd     8     1.5    │
  887.                  │   COM3   300     Even          2      │
  888.                  │   COM4   600     Mark                 │
  889.                  │   COM5   1200    Space                │
  890.                  │   COM6   2400                         │
  891.                  │   COM7   4800                         │
  892.                  │   COM8   9600                         │
  893.                  │          19200                        │
  894.                  │          38400                        │
  895.                  │          57600                        │
  896.                  │                                       │
  897.                  │  [ENTER] accept        [ESC] abort    │
  898.                  └───────────────────────────────────────┘
  899.                                 Figure BB.
  900.                     The "Alt-P Parameters" Menu Display
  901.  
  902.  
  903.           If you do not wish to change the current settings, you
  904.         should press ESCape when you are done viewing the
  905.         display.  If you have changed any of the settings, they
  906.         will be discarded unless you press the ENTER key.  If
  907.         TE/2 is unable to set the communications port to the
  908.         values you specified, it will present you with an error
  909.         message and no parameter's setting will have been changed.
  910.         If TE/2 was successful however, the menu display will
  911.         simply disappear.
  912.  
  913.           NOTE: In this release of TE/2, only comm ports COM1
  914.         through COM8 may be selected via this menu.  There is no
  915.         facility for changing the communications device if it has
  916.         a name other than one of these eight.  Furthermore, if
  917.         you selected a communications port via the "Device"
  918.         directive in TE2.INI, whether is has one of the names
  919.         listed above or not, that choice may not be accurately
  920.         reflected in this display.
  921.  
  922.  
  923.       Alt-Q Queue Dial
  924.       ================
  925.  
  926.           This function is exactly equivalent to the Queue Dial
  927.         function in the Dialing Directory section of TE/2.  If
  928.         you have marked any dialing directory entries for the
  929.         queue while in the dialing directory (see that section of
  930.         this document for further information) this function will
  931.         restart the Queue Dialer at the beginning of the queue.
  932.  
  933.  
  934.       Alt-R Redial
  935.       ============
  936.  
  937.           This function will redial the very last number which
  938.         was dialed whether that dialing attempt succeeded or
  939.         failed and whether the number was dialed via the Dialing
  940.         Directory, the Queue Dialer, or Manual Dial.
  941.  
  942.  
  943.       Alt-S Snap Shot
  944.       ===============
  945.  
  946.           This function will save the contents of the current
  947.         screen to a disk file.  The files name is TE2SNAP.SHT and
  948.         will reside in the current directory unless you have
  949.         specified an alternate file name in TE2.INI (see the
  950.         section on Customization).  If the file already exists,
  951.         the screen image will be appended to the file so as not
  952.         to overwrite what is already in the file.
  953.  
  954.  
  955.       Alt-T Logfile Toggle
  956.       ====================
  957.  
  958.           Toggles the Paused/Active status of the open log file.
  959.         If no log file is open, this function does nothing. 
  960.         Otherwise, if the log file is currently active, this
  961.         function will "Pause" is, activity on the terminal
  962.         display will not be placed in the log file while it is
  963.         paused.  If the log file is currently in the Paused
  964.         state, this function will reactivate it.
  965.  
  966.           The current status of the log file (open or closed,
  967.         paused or active) can be obtained by using the "Alt-I
  968.         Information" function.  See also "Alt-L Logfile
  969.         Open/Close" for more information on the log file.
  970.  
  971.  
  972.       Alt-U Upload  (Also: Gray PgUp key)
  973.       ============
  974.  
  975.           This presents a menu of the available upload protocol
  976.         choices.  The choices available in the current version
  977.         of TE/2 are:
  978.  
  979.                 XModem
  980.                 XModem1K
  981.                 YModem
  982.                 YModem-G
  983.                 ZModem
  984.                 Ascii
  985.  
  986.           For the first five please refer to the "Alt-N Download"
  987.         section for details, upload is very much like download
  988.         with the obvious exception of the fact that during an
  989.         upload you are sending a file or files while during a
  990.         download you are receiving.  One other difference is that
  991.         you are prompted for the file or files to upload in each
  992.         of the five protocols, for XModem and XModem1K you may
  993.         specify one and only one file for upload, for YModem,
  994.         YModem-G, and ZModem you may specify a "wildcard" file
  995.         name.  This is to say, you may transmit all files with
  996.         the extension ".ZIP" in the current directory by
  997.         answering "*.ZIP" at this prompt.  This wildcard handling
  998.         is exactly the same as when you are at the OS/2 command
  999.         line prompt.
  1000.  
  1001.  
  1002.         CompuServe B Plus Protocol
  1003.  
  1004.           Note that CompuServe B Plus protocol is only available in
  1005.         the registered version of TE/2.
  1006.  
  1007.           This protocol does NOT appear on the upload or download
  1008.         protocol menus because of the client-server nature of the
  1009.         CompuServe Transport Layer.  Please refer to the notes in the
  1010.         discussion of Download Protocols and also in the section on
  1011.         the Protocol Status Display for more notes regarding
  1012.         CompuServe B Plus Protocol.
  1013.  
  1014.  
  1015.         ASCII Uploads
  1016.  
  1017.           The Ascii upload protocol is a bit different from the
  1018.         rest.  Whereas the other protocols are all capable of
  1019.         transmitting and receiving binary files (program files,
  1020.         archives, 123 spreadsheets, etc.) the Ascii upload
  1021.         protocol is for text files only.  You would usually use
  1022.         this protocol for entering previously composed messages
  1023.         into a bulletin board message base or similar activities.
  1024.         There is no special state or protocol that must be
  1025.         activated on the receiving end other than the remote
  1026.         system must be in a state where it expects text entry
  1027.         from you.  When you begin an Ascii upload you are
  1028.         presented with the dialog box in Figure CC.
  1029.  
  1030.  
  1031.           ┌───────────────────────────────────────────────────────────┐
  1032.           │ Enter file name for Ascii Upload:                         │
  1033.           │ █████████████████████████████████████████████████████████ │
  1034.           │                                                           │
  1035.           │     Prompt Char: None          End of Line Seq: Yes       │
  1036.           │     Char Pacing: 0  ms      Expand Blank Lines: Yes       │
  1037.           │     Line Pacing: 0  ms             View Output: No        │
  1038.           │                                  Strip 8th bit: No        │
  1039.           │                                                           │
  1040.           │ [ENTER] Begin   [ESC] Abort   [] Select  [SPACE] Toggle │
  1041.           │                                                           │
  1042.           └───────────────────────────────────────────────────────────┘
  1043.                                 Figure CC.
  1044.                      Ascii Upload Information Dialog
  1045.  
  1046.  
  1047.           You may move about within the dialog using the arrow
  1048.         keys and/or the TAB/Shift-TAB keys and answer the various
  1049.         questions if any need modification.  These are discussed
  1050.         individually below.  When you are ready to send the file,
  1051.         press ENTER, use ESCape to abort the process.
  1052.  
  1053.           The only field which absolutely needs to be filled in
  1054.         is the file name field.  You must type the name of an
  1055.         existing text file in this area.  When you have typed
  1056.         the file name, do not use the ENTER key unless you have
  1057.         no other fields in the dialog to adjust, use the arrow
  1058.         or TAB keys instead to position the highlight on the
  1059.         desired field.
  1060.  
  1061.         Prompt Char
  1062.               On some bulletin boards and services, the message
  1063.             editor will "prompt" you for each line of input, on some
  1064.             text entry of messages is entirely free form.  For
  1065.             instance, when entering a message on GEnie, once you have
  1066.             typed the first line of text you must wait for GEnie to
  1067.             respond with the prompt "2>" before proceeding and again
  1068.             for "3>" on the next line, et cetera.  Thus for GEnie you
  1069.             would want to set the Prompt Char to ">".  You do this
  1070.             simply by typing ">" when to words "Prompt Char" are
  1071.             highlighted.  Other bulletin boards may use "nnn:" (where
  1072.             "nnn" is the next line number), for these you would set
  1073.             the prompt character to ":".
  1074.               The effect of all of this is to cause the Ascii upload
  1075.             protocol to wait after it has sent each line until it
  1076.             receives the prompt character from the remote service.
  1077.               To reset the prompt character to "None" you must use
  1078.             the space bar.  This implies that the space character may
  1079.             never be used as a prompt character, which is probably
  1080.             not a major problem.
  1081.             
  1082.         Char Pacing
  1083.               This is the time, in milliseconds, that the Ascii
  1084.             upload protocol will wait between transmitting successive
  1085.             characters.  Set this to a higher value if the remote
  1086.             system seems to be losing some characters out of your
  1087.             text.
  1088.  
  1089.         Line Pacing
  1090.               This is the time, in milliseconds, that the Ascii
  1091.             upload protocol will wait between transmitting successive
  1092.             lines of text.  This will be most useful in situations
  1093.             where you have not specified a prompt character and
  1094.             the remote seems to be losing parts of or entire lines
  1095.             of your text.
  1096.  
  1097.  
  1098.         End of Line Seq
  1099.               This may be set to "LF", "CRLF", or "CR", you cycle
  1100.             through the values by using the space bar when the
  1101.             highlight is on this prompt.  If it is set to "LF" then
  1102.             each line of text that is sent will be terminated with
  1103.             a single line feed character (ascii code 10).  If it is
  1104.             set to "CRLF" the each line of text will be terminated
  1105.             with a carriage return (ascii 13) and a line feed.  If it
  1106.             is set to "CR" then each line will be terminated with a
  1107.             single carriage-return character.
  1108.  
  1109.  
  1110.         Expand Blank Lines
  1111.               This may be set to "Yes" or "No"; you alternate between
  1112.             the values by using the space bar when the highlight is
  1113.             on this prompt.  Some bulletin boards and services assume
  1114.             that a blank line (that is a line with nothing on it at
  1115.             all, not even space characters) is the end of the input.
  1116.             If the text file you are uploading contains blank lines
  1117.             this will cause problems.  If this option is set to yes
  1118.             then blank lines in the file are sent out as lines
  1119.             containing a single space character.
  1120.  
  1121.  
  1122.         View Output
  1123.               This may be set to "Yes" or "No"; you alternate between
  1124.             the values by using the space bar when the highlight is
  1125.             on this prompt.  This will usually be set to false only
  1126.             if the bulletin board or service has an actual text mode
  1127.             or ascii upload mode wherein it does not display the
  1128.             incoming text.
  1129.  
  1130.  
  1131.         Strip 8th bit
  1132.               This may be set to "Yes" or "No", you alternate between
  1133.             the values by using the space bar when the highlight is
  1134.             on this prompt.  Some services and mainframe hosts are
  1135.             not able to accept the entire 8 bit Ascii character set
  1136.             as input (the Extended Ascii set actually).  If this
  1137.             option is set to yes, any character with an Extended
  1138.             Ascii code greater than 127 will have 128 subtracted from
  1139.             its ascii value before it is sent, effectively mapping
  1140.             the entire 8 bit Extended Ascii character set onto the
  1141.             7 bit Standard Ascii character set.  Note that this will
  1142.             cause characters such as the IBM box drawing characters,
  1143.             accented, international language characters, and extra
  1144.             symbols to appear differently, perhaps confusingly so,
  1145.             to the receiver.
  1146.  
  1147.  
  1148.  
  1149.       Alt-V LF after CR
  1150.       =================
  1151.  
  1152.           Normally, when you press the ENTER key in terminal mode,
  1153.         a carriage return character (ascii 13) is transmitted.  If
  1154.         this option is toggled on, the key produces a carriage
  1155.         return followed by a line feed character (ascii 10).
  1156.  
  1157.           This defaults to OFF unless you have reset the default
  1158.         behavior via the initialization file (see the section on
  1159.         Customization).  You can determine the current state of this
  1160.         setting by viewing the Alt-I Information display.
  1161.  
  1162.           If you are currently in VT100 emulation mode, Alt-V will
  1163.         effectively toggle the terminal emulation into and out of
  1164.         the VT100's Newline mode.  Note that this will change the
  1165.         translation of incoming LINEFEED characters.  This will
  1166.         happen in VT100 mode only.
  1167.  
  1168.  
  1169.       Alt-W Scroll Back
  1170.       =================
  1171.  
  1172.           This allows you to view, and interact with, the contents
  1173.         of TE/2's scroll back buffer.  See the section below on the
  1174.         scroll back buffer for further information.
  1175.  
  1176.  
  1177.       Alt-X Exit to OS/2
  1178.       ==================
  1179.  
  1180.           This will terminate TE/2 and return you to the OS/2 command
  1181.         line prompt or the Presentation Manager depending on the
  1182.         method you used to start TE/2.  If you are currently on-line
  1183.         when you attempt to exit, TE/2 will ask you for verification
  1184.         before proceeding.  If you are on-line at exit time, TE/2 will
  1185.         hang up the line (see Alt-H Hangup) before exiting.
  1186.  
  1187.  
  1188.  
  1189.       Alt-Z Toggle Menu
  1190.       =================
  1191.  
  1192.           Use this to display or hide the 10 line keystroke menu at
  1193.         the bottom of the terminal screen.  The terminal screen is
  1194.         effectively ten lines larger when the menu is hidden.
  1195.  
  1196.  
  1197.       Control-BREAK
  1198.       =============
  1199.  
  1200.           When a Control-BREAK is encountered (at any point during
  1201.         execution, not just in terminal mode), you will be presented
  1202.         with a popup menu that will allow you to Resume execution,
  1203.         Resume execution after flushing the I/O buffers, or to exit
  1204.         TE/2 immediately.  In the registered version, if a script is
  1205.         currently executing, you will also have the option to abort
  1206.         the current script or all nested scripts.
  1207.  
  1208.           Note that "Flushing the I/O buffers" may or may not restart
  1209.         flow to and from the comm port, depending on the reason flow
  1210.         is blocked.  The buffers which are flushed are the device
  1211.         driver's not TE/2's.  This action will get you going again,
  1212.         however, if TE/2 is waiting for the remote to send an XON
  1213.         character after receiving a false XOFF.  If XonXoff is
  1214.         enabled for transmit, an XON character will also be
  1215.         immediately transmitted to the remote.
  1216.  
  1217.  
  1218.       B. The Dialing Directory
  1219.  
  1220.  
  1221.     The Dialing Directory is your "Little Black Book" into the world.
  1222.   This section of the program allows you to record and save telephone
  1223.   numbers and associated information for up to 200 bulletin boards
  1224.   and/or host services.  If two hundred is not sufficient for your
  1225.   needs, you may have as many optional dialing directory files as you
  1226.   wish, each one capable of containing up to 200 phone numbers.
  1227.  
  1228.     Each entry in the Dialing Directory may contain some or all of
  1229.   the following information:
  1230.  
  1231.     o  Name:
  1232.         The name of the BBS or service in a meaningful form. This name
  1233.         will be displayed during dialing, upon making a connection with
  1234.         the number, and in the TE2CALL.LOG usage file.
  1235.  
  1236.     o Tag:
  1237.         A five character "nickname" for this entry.  This field is
  1238.         not used by this version in any way however it is present so
  1239.         that directory files will be consistent with the registered
  1240.         version of TE/2.  This field is available to programs written
  1241.         in the TE/2 Script Language that accompanies the registered
  1242.         version (see the section on Registering TE/2 for more
  1243.         information on this subject).
  1244.  
  1245.     o Number:
  1246.         The phone number to dial.  This can contain numbers up to 29
  1247.         characters in length.  This number will be passed directly to
  1248.         your modem when TE/2 attempts to dial this entry.  In the
  1249.         simplest case, this is just a phone number the way you are
  1250.         used to seeing such numbers (i.e., "1-123-555-1212").  Your
  1251.         modem will probably allow you to put other characters into
  1252.         the numbers to activate certain special features such as
  1253.         pauses, wait for dial tone and continue, switch-hooking, et
  1254.         cetera.  You should consult your modem manual for details.
  1255.         Please note, you do not have to put the actual modem dialing
  1256.         command into this string ("ATD" or "ATDT" on Hayes compatible
  1257.         modems).  This part of the dialing process is handled auto-
  1258.         matically by TE/2's dialer.
  1259.  
  1260.         Notes Regarding Alpha Characters in Phone Numbers:
  1261.  
  1262.         Some modems allow you to specify a letter associated with the
  1263.         number on the phone dial or keypad instead of the number. To
  1264.         do so you usually need to inclose the alpha portion in quotes.
  1265.         Thus, MCI Mail's phone number could be specified as:
  1266.         1-800-645"MAIL" (the closing quote being optional because no
  1267.         further numeric data occurs in the string).  TE/2 will pass
  1268.         any quoted alphabetic characters to the modem untranslated
  1269.         along with the actual quote character(s).
  1270.  
  1271.         The registered version of TE/2 contains an Access Code lookup
  1272.         table of ten entries that allows you to define extended
  1273.         strings that may be embedded into a phone number using the
  1274.         letters A through J.  An empty access code entry will return
  1275.         the empty string.  The shareware version does not support
  1276.         Access Codes so all entries in this table are, by definition,
  1277.         empty, thus any of the letters A through J when they appear
  1278.         unquoted in a phone number are effectively stripped away.
  1279.  
  1280.         Any letter K through Z which appears, unquoted, in a phone
  1281.         number will be sent intact to the modem.  This is useful if
  1282.         one needs to use the Hayes "W" (wait for second dialtone)
  1283.         in a phone number.
  1284.  
  1285.     o Line Parameters:
  1286.         You may specify the what baud rate, parity, word length, and
  1287.         number of stop bits to use while connected to this number.
  1288.         Once the dialer has successfully connected with the number,
  1289.         these line parameters will be automatically set for you.
  1290.         You may, of course, reset them at any time after this via
  1291.         the Alt-P Parameters function.
  1292.  
  1293.     o Local Echo:
  1294.         You specify whether Local Echo mode should be turned on or
  1295.         off when the dialer successfully connects with this number.
  1296.         You may reset this at any time after this via the Alt-E
  1297.         Local Echo function.
  1298.  
  1299.     o Default Protocol:
  1300.         This specifies the preferred file transfer protocol for this
  1301.         number.  When you use the upload or download functions
  1302.         (Alt-U Upload, Alt-N Download, or the Gray PgUp/PgDn keys)
  1303.         this will be the highlighted line on the menu of available
  1304.         protocols when the menu appears.  You may the simply press
  1305.         ENTER to use this protocol.  You may, of course, select any
  1306.         other item on this menu instead.
  1307.         Note that "Ascii" is an option on this menu.  Because this
  1308.         is an "upload only" protocol (ascii downloads are handled
  1309.         by using the Log File functions), entries that specify this
  1310.         as the default protocol will have it apply only to uploads.
  1311.         The download protocol will default to the most recently
  1312.         used protocol.  You should specify this as the default
  1313.         protocol for services like MCI Mail where you typically
  1314.         upload only text material.
  1315.         Note further that choosing CompuServe B Plus protocol for
  1316.         the default protocol has a somewhat different meaning also.
  1317.         CompuServe maintains a client-server based transport layer
  1318.         between itself and the terminal program.  If you want to
  1319.         be able to use this protocol with CompuServe, you must
  1320.         select it as the default protocol for CIS's entry in your
  1321.         Dialing Directory.  For more notes concerning CIS B Plus,
  1322.         see the sections, elsewhere in this document, regarding
  1323.         Download Protocols and the Protocol Status Display.
  1324.  
  1325.     o Terminal Emulation:
  1326.         Specifies the terminal emulation mode to automatically select
  1327.         once the dialer has successfully connected with this number.
  1328.         You may reset this at any time after this via the Alt-A
  1329.         Terminal Emulation function.
  1330.  
  1331.     o Script File:
  1332.         This field is not used in any way by the current version of
  1333.         TE/2.  It present so that directory files will be consistent
  1334.         with the registered version of TE/2.  In the registered
  1335.         version, this names a program file written in the TE/2 Script
  1336.         Language that will be automatically executed when the dialer
  1337.         successfully connects with this number (see the section on
  1338.         Registering TE/2 for more information on this subject).
  1339.  
  1340.  
  1341. ┌────────────────────────────────────────────────────────────────────────────┐
  1342. │                           Dialing Directory                                │
  1343. │                               File Name                                    │
  1344. ├────────────────────────────────────────────────────────────────────────────┤
  1345. │   Tag    Name                    Parms      Number                         │
  1346. │                                                                            │
  1347. │ 1 ..... ........................ ........ . .............................. │
  1348. │ 2 ..... ........................ ........ . .............................. │
  1349. │ 3 ..... ........................ ........ . .............................. │
  1350. .                                                                            .
  1351. .                                                                            .
  1352. .                                                                            .
  1353. ├────────────────────────────────────────────────────────────────────────────┤
  1354. │ [ENTER] Dial Entry [INS] Insert New Entry  [C] Change Entry  [S] Save File │
  1355. │ [ESC]   Exit       [DEL] Delete Entry      [T] Toggle Info   [N] New File  │
  1356. │ [/]   Select     [SPACE] Mark/Unmark     [Q] Queue Dial                  │
  1357. └────────────────────────────────────────────────────────────────────────────┘
  1358.                                 Figure DD.
  1359.                       TE/2 Dialing Directory Display
  1360.  
  1361.  
  1362.     When you enter the Dialing Directory your screen will resemble
  1363.   what you see in Figure DD (it uses the entire screen, the vertical
  1364.   sequence of dots at the left and right edges imply that information
  1365.   has been omitted).  The current Dialing Directory file name will be
  1366.   displayed where you see "File Name" in the figure.  By default this
  1367.   will be "te2.dir" but this may be changed via the "[N] New File"
  1368.   key.  At the bottom of the screen will be the menu of available
  1369.   keys as shown in the figure.  The entire central portion of the
  1370.   screen will be occupied by the actual directory entries.  The first
  1371.   entry will be highlighted if this is the first time in the Dialing
  1372.   Directory during this session with TE/2, otherwise the highlighting
  1373.   will be on the same entry that was highlighted the last time you
  1374.   viewed the Dialing Directory.
  1375.  
  1376.     These are the functions that are available to you while in the
  1377.   Dialing Directory.
  1378.  
  1379.       [/] Select
  1380.           You may move the highlighted bar up and down through the
  1381.         entries, scrolling the display if necessary, to select the
  1382.         entry you are interested in.  Other keys available for
  1383.         navigation through the directory but not listed on the menu
  1384.         are:
  1385.                 [PgUp] - move the highlighted bar back one page
  1386.                 [PgDn] - move the highlighted bar forward one page
  1387.                 [Home] - move the highlighted bar to the first entry
  1388.                 [End]  - move the highlighted bar to the last entry
  1389.  
  1390.           In addition to all of this, the numeric keys 0 through 9
  1391.         can be used for a type of incremental search through the
  1392.         directory.  For instance, if the highlight is on entry number
  1393.         two and you type the "3" the highlight will move to the
  1394.         third entry.  If you type the "3" again, the highlight moves
  1395.         to the thirty-third entry.  If you type the "3" again, the
  1396.         highlight remains where it is because there is no entry
  1397.         number 333.  The search works only in the forward direction
  1398.         and any key stroke other than a number key restarts the
  1399.         sequence.  Thus, if the highlight is on entry 57 and you want
  1400.         to quickly move to entry number 24, the fastest way there is
  1401.         the keystroke sequence: [Home],2,4.
  1402.  
  1403.         NOTE: If you hold down the Control Key while using the up and
  1404.         down arrows, you may "drag" the current directory entry along
  1405.         with the highlighted bar.  You can use this feature to manually
  1406.         reorder the entries in your directory.  Changes in the order
  1407.         of the entries must be saved to disk by pressing [S].  See
  1408.         the notes later in this section on sorting directory files.
  1409.  
  1410.  
  1411.       [ENTER] Dial Entry
  1412.           This will submit the highlighted entry to TE/2 phone
  1413.         dialer.
  1414.  
  1415.       [ESC] Exit
  1416.           This will exit the Dialing Directory display and return you
  1417.         to the terminal screen display.
  1418.  
  1419.       [C] Change Entry
  1420.           This will present you with a dialog box wherein you may
  1421.         specify or respecify all of the information to be associated
  1422.         with the highlighted entry as outlined above.
  1423.  
  1424.       [INS] Insert New Entry
  1425.           This will create a new, blank entry at the highlighted
  1426.         position, move all succeeding entries down one position in
  1427.         the list, and place you in the same dialog box for entering
  1428.         information as "[C] Change Entry" mentioned above.
  1429.           If there is an entry defined at position 200, you will be
  1430.         asked if you want to continue because it will be deleted by
  1431.         this process.
  1432.  
  1433.       [DEL] Delete Entry
  1434.           Removes the highlighted entry and moves all succeeding
  1435.         entries back up by one, closing the "hole".  A blank entry
  1436.         is inserted at position 200.  You will be asked to verify
  1437.         the deletion before it is actually performed.
  1438.  
  1439.       [S] Save File
  1440.           TE/2 may be configured to automatically save the directory
  1441.         file every time you leave the screen or it may be configured
  1442.         so that you must manually save any changes you have made (see
  1443.         the section on Customization).  Regardless of this setting,
  1444.         you may use this function to save the current directory
  1445.         information to a file immediately.  You will be prompted to
  1446.         enter a file name which does not need to be the same as the
  1447.         current directory file.
  1448.  
  1449.       [N] New File
  1450.           This will prompt you for and load a new directory file
  1451.         (usually one created via the "[S] Save File" function).  Be
  1452.         careful if you have made any changes to the current directory
  1453.         information that you wish to keep.  You should make sure that
  1454.         the current directory file has been saved (either
  1455.         automatically or manually) before loading a new file.
  1456.  
  1457.       [T] Toggle Info
  1458.           This keystroke cycles the directory display through several
  1459.         states.  By default the rightmost column show the telephone
  1460.         number associated with each directory entry.  Through
  1461.         successive uses of this key you may view any of the following
  1462.         information for all entries:
  1463.  
  1464.                 Script File
  1465.                   Display the names of the associated script files
  1466.                 in the rightmost column.
  1467.  
  1468.                 Last Connect - Count
  1469.                   Display the time and date of the last time you
  1470.                 connected to this number and a count of how many
  1471.                 times connection has been made.
  1472.  
  1473.                 Protocol - Emulation
  1474.                   Display the default protocol and terminal emulation
  1475.                 associated with each entry.
  1476.  
  1477.  
  1478.       [SPACE] Mark/Unmark
  1479.           The space bar will mark or unmark the highlighted entry.
  1480.         A marked entry has a triangular arrow placed on the display
  1481.         pointing at its tag.  A marked entry is placed on the "queue"
  1482.         for use with the Queue Dialer (see below).
  1483.  
  1484.       [Q] Queue Dial
  1485.           If there are marked entries (see above) in the current
  1486.         directory, this key activates TE/2's Queue Dialer.  This
  1487.         will dial each marked entry in turn until one of them is
  1488.         connected with or until you press the ESCape key.  When an
  1489.         entry has been connected with, it is unmarked and removed
  1490.         from the queue.
  1491.  
  1492.  
  1493.       Sorting Directory Files
  1494.  
  1495.     From within the Directory display, you may move entries from
  1496.   place to place within the list using Control-UpArrow and
  1497.   Control-DownArrow to "drag" entries along with the highlighted
  1498.   bar.  This is useful for ordering entries by arbitrary groupings
  1499.   such as migrating more commonly dialed entries to the beginning
  1500.   of the list or grouping Bulletin Board entries by geographical
  1501.   region.
  1502.  
  1503.     For a more general solution, various utilities are available for
  1504.   manipulating TE/2 directory files.  The structure of the TE/2
  1505.   directory file is documented and available to the general public.
  1506.   If you would like copies of the available utilities, documentation,
  1507.   and sample source code, you may download these from the Oberon BBS.
  1508.   You will find the BBS number and details listed at the beginning
  1509.   and again at the end of this document.  Alternately, you may send
  1510.   a blank diskette to Oberon Software with a note stating your
  1511.   request, and return postage and we will mail the material to you.
  1512.  
  1513.  
  1514.  
  1515.       C. Dialer
  1516.  
  1517.     TE/2's Phone Dialer is invoked when you press ENTER while in the
  1518.   Dialing Directory, when ever you invoke the Queue Dial function
  1519.   either from the Dialing Directory or from Terminal Mode (assuming
  1520.   that at least one directory entry is "marked" - see above), and
  1521.   when you invoke the Redial or Manual Dial functions.  While it is
  1522.   dialing, a dialog box appears on the screen that will keep you
  1523.   informed of what the dialer is currently doing.
  1524.  
  1525.  
  1526.         ┌────────────────────────────────────────────┐
  1527.         │             Dialing Number                 │
  1528.         │                                            │
  1529.         │        Name:                               │
  1530.         │      Number:                               │
  1531.         │  Parameters:                               │
  1532.         │      Status:                               │
  1533.         │       Tries:                               │
  1534.         │                                            │
  1535.         │ [ESC] exit  [DEL] remove  [SPACE] recycle  │
  1536.         └────────────────────────────────────────────┘
  1537.                         Figure EE.
  1538.                     Dialer Dialog Box
  1539.  
  1540.  
  1541.     The following information is displayed by the dialer's dialog:
  1542.  
  1543.       Name
  1544.         The directory entry name of the number being dialed. If this
  1545.         was a manual dial, this will be blank.
  1546.  
  1547.       Number
  1548.         The phone number being dialed as entered in the Dialing
  1549.         Directory or at the Manual Dial prompt.
  1550.  
  1551.       Parameters
  1552.         The baud, parity, word length, and number of stop bits which
  1553.         are associated with this number.  If a connection is
  1554.         successful, TE/2's parameters will be set to these values.
  1555.  
  1556.       Status
  1557.         This will contain various messages generated either by the
  1558.         dialer itself or by the modem during the dialing process.
  1559.         For example, it begins by the message "DIALING", if you
  1560.         press the ESCape key, it will display "ABORT" before exiting.
  1561.         If you press the ESCape key it will display "Recycle"
  1562.         momentarily and the "Pausing" while it is in the delay cycle
  1563.         between dial attempts.  If your modem returns a "BUSY"
  1564.         response, that message will appear.
  1565.  
  1566.       Tries
  1567.         This is the number of times that this number has been tried
  1568.         unsuccessfully during the current dial attempt.
  1569.  
  1570.  
  1571.     The following keystrokes are recognized by the dialer. All other
  1572.   keystrokes are discarded.
  1573.  
  1574.       [ESC] exit
  1575.         Ends the dial attempt and returns control to the Dialing
  1576.         Directory screen or the Terminal Mode screen depending upon
  1577.         where you were when you invoked the dialer.  This does not
  1578.         "unmark" any entries that have been marked for queue dialing
  1579.         but it does clear the "Tries" indicator for each entry in
  1580.         the queue.
  1581.  
  1582.       [DEL] remove
  1583.         When Queue Dialing, this will abort the dial attempt for the
  1584.         current number only and remove it from the dialing queue
  1585.         ("unmark" it).  If this was the last number in the queue (or
  1586.         the only number in the case of a single number dial), the
  1587.         dialer will be aborted and control will be returned to the
  1588.         Dialing Directory or the Terminal Mode depended upon where
  1589.         you were when you invoked the dialer.
  1590.  
  1591.       [SPACE] recycle
  1592.         This causes aborts attempt to connect with the current number
  1593.         only and moves on to the next attempt.  This may be the next
  1594.         number in the dialing queue or simply on to a retry of the
  1595.         current number if there is only one number in the queue or
  1596.         this was a single number dial attempt.
  1597.  
  1598.  
  1599.  
  1600.       D. Chat Mode
  1601.  
  1602.     TE/2 supplies a built in, split screen chat mode for use with
  1603.   the CB Simulators provided by some on-line services, multiuser
  1604.   real-time conferences provided by some services and bulletin
  1605.   boards, and chatting with bulletin board sysops if they offer a
  1606.   chat mode on their BBS.
  1607.  
  1608.     When TE/2's Chat Mode is activated, the contents of the current
  1609.   screen are saved (and will be restored when you exit chat mode) and
  1610.   you are presented with the Chat Mode display.  This display divides
  1611.   the screen into two "windows".  In the top window, label "Remote",
  1612.   all characters coming from the remote source are displayed.  In the
  1613.   lower window, labeled "Local", the characters you type are
  1614.   displayed.
  1615.  
  1616.     Chat Mode has, itself, two modes of operation: buffered and
  1617.   unbuffered.  In unbuffered mode all character which you type into
  1618.   the "Local" window are immediately transmitted to the remote
  1619.   connection.  In buffered mode, they are saved (in a "buffer") until
  1620.   you press the ENTER key at which time they are sent in a "packet".
  1621.  
  1622.     Many of the terminal mode functions are also available when you
  1623.   are in Chat Mode plus several that are unique to Chat Mode.  If you
  1624.   press Alt-Z while in Chat Mode you will be given a menu of avail-
  1625.   able keystrokes and functions.
  1626.  
  1627.  
  1628.         ┌──────────────────────────────────────────────────┐
  1629.         │ ALT-B Send Break Signal   ALT-U  Upload          │
  1630.         │ ALT-C Clear Screen        ALT-V  LF after CR     │
  1631.         │ ALT-F Output Buffering    ALT-W  Scroll Back     │
  1632.         │ ALT-I Information         ALT-X  Exit Chat Mode  │
  1633.         │ ALT-J User Programs       ALT-Z  This menu       │
  1634.         │ ALT-L Logfile Open/Close  CTRL-K Restart Line    │
  1635.         │ ALT-N Download            ESCape Exit Chat Mode  │
  1636.         │ ALT-O OS/2 Shell          PgUp   Upload          │
  1637.         │ ALT-P Parameters          PgDn   Download        │
  1638.         │ ALT-T Logfile Toggle                             │
  1639.         └──────────────────────────────────────────────────┘
  1640.                              Figure FF.
  1641.                            Chat Mode Menu
  1642.  
  1643.  
  1644.     The following Chat Mode functions behave exactly like they
  1645.   do in terminal mode; refer to the appropriate discussion
  1646.   above for details.
  1647.  
  1648.       Send Break Signal
  1649.       Clear Screen
  1650.       Information
  1651.       User Programs
  1652.       Logfile Open/Close
  1653.       Download
  1654.       OS/2 Shell
  1655.       Parameters
  1656.       Logfile Toggle
  1657.       Upload
  1658.       LF after CR
  1659.       Scroll Back
  1660.  
  1661.  
  1662.     The following functions are unique to Chat Mode.
  1663.  
  1664.       Output Buffering
  1665.         Toggle between buffered and unbuffered mode.
  1666.  
  1667.       Restart Line
  1668.         For use in buffered mode, this function will discard all
  1669.         characters currently pending allowing you to restart the
  1670.         line.
  1671.  
  1672.       Exit Chat Mode
  1673.         This is, of course, rather self explanatory.  The terminal
  1674.         screen is restored upon leaving Chat Mode.
  1675.  
  1676.  
  1677.  
  1678.       E. The Scroll Back Buffer
  1679.  
  1680.  
  1681.     When you invoke TE/2 Scroll Back Buffer, you may view everything
  1682.   that has appeared on TE/2's Terminal Mode screen in the recent
  1683.   past.  By default, the last 250 lines of text that have appeared
  1684.   on the terminal screen are retained for the Scroll Back Buffer.
  1685.   You are allowed to set this number to a higher or lower value (or
  1686.   disable the Scroll Back Buffer feature entirely) through a setting
  1687.   in the TE2.INI file (see the section on Customization) for details.
  1688.   
  1689.     When the Scroll Back Buffer display first appears, the contents
  1690.   of your screen will look very much like the current terminal
  1691.   screen.  This is because you enter Scroll Back Mode at the bottom
  1692.   (the most recent part) of the buffer.  You may move backwards and
  1693.   forwards within the buffer using the cursor movement keys.  In
  1694.   addition to the cursor keys, there are a number of other functions
  1695.   available for locating text within the buffer and for writing all
  1696.   or part of the buffer to a disk file.  A run down of all the keys
  1697.   available in Scroll Back mode are listed here.
  1698.  
  1699.  
  1700.     Cursor Keys
  1701.         Up, Down, PgUp, PgDn, Home, End all behave as you would
  1702.         expect.  That is, the arrow keys move you backward and
  1703.         forward a line at a time, PgUp and PgDn move a screen at
  1704.         time, and Home and End move you to the beginning or the
  1705.         end of the buffer respectively.
  1706.  
  1707.  
  1708.     Exit Scroll Back
  1709.       [ESC]
  1710.         Pressing the ESCape key will cancel Scroll Back Mode and
  1711.         return control to the Terminal Screen or the Chat Mode
  1712.         display depending upon where you were when you invoked
  1713.         the Scroll Back Buffer.
  1714.         Note: You may also use Alt-X to cancel Scroll Back Mode.
  1715.  
  1716.  
  1717.     Text Searches
  1718.       [F]
  1719.         Use the "F" key begin a text search through the buffer.
  1720.         You will be asked to provide the text to search for.
  1721.         The search is case-insensitive, this is to say that
  1722.         "Fred And Barney" will match "fred and barney" as well as
  1723.         "fred AND barney".  The search begins at the line of the
  1724.         buffer which is currently displayed at the top of the screen.
  1725.         Note: You may also use the backslash key to begin a search.
  1726.  
  1727.       [N]
  1728.         Like the "F" key above but rather than querying for the
  1729.         text to search for it will simply continue searching for
  1730.         the last specified string.
  1731.         Note: You may also use "A" to continue a search.
  1732.  
  1733.  
  1734.     The Marked Area
  1735.       The keystrokes mentioned below are used to define a "marked area"
  1736.     within the Scroll Back Buffer.  This area will be displayed in an
  1737.     alternate color from the rest of the Scroll Back Buffer.  The
  1738.     mark defines exactly which lines will be written to disk when the
  1739.     "W" key is pressed.
  1740.  
  1741.       [T]
  1742.         "Marks" the top line of the display.  If there currently is
  1743.         no marked area, the top line of the screen becomes both the
  1744.         top and bottom line of the marked area.  Otherwise, the
  1745.         marked area is expanded or contracted appropriately.
  1746.         Note: You may also use "M" to mark the top line of the
  1747.         display.
  1748.  
  1749.       [B]
  1750.         "Marks" the bottom line of the display.  If there currently
  1751.         is no marked area, the bottom line of the screen becomes both
  1752.         the top and bottom line of the marked area.  Otherwise, the
  1753.         marked area is expanded or contracted appropriately.
  1754.  
  1755.       [Q]
  1756.         If an area of the scroll back buffer has been marked (see [T]
  1757.         and [B] above), this will allow you to upload that marked
  1758.         area as an ascii upload.  You will be given a menu that asks
  1759.         whether you want the upload formatted as a quote or not.  If
  1760.         you select Unformatted, the marked text will be sent "as-is".
  1761.         If you select Formatted, however, you will be further queried
  1762.         for the "Initials" to use, you may specify any string, up to
  1763.         ten characters long here.  This feature is typically used
  1764.         when replying to messages or E-Mail on BBSes or on-line
  1765.         services and you wish to quote another letter writer; the
  1766.         "Initials" are meant to be an indication of whom you are
  1767.         quoting.  When formatted text is uploaded, each line will be
  1768.         preceded with a two character left margin and "XX> " (where
  1769.         "XX" represents the initials you specified), and the text
  1770.         will be reformatted with intelligent word wrapping to fit
  1771.         into 72 columns.  For either type of upload, you will be
  1772.         shown a variation on the Ascii Upload dialog window (see
  1773.         Figure CC.) and you may change any of the Ascii Upload
  1774.         parameters at this point or simply press ENTER to begin.
  1775.         Note: There are several alternate keystrokes which invoke
  1776.         this function: Alt-Q, U, and Alt-U.
  1777.  
  1778.       [W]
  1779.         This will prompt for a file name and write the marked area of
  1780.         the Scroll Back Buffer to the file you specify.  If the file
  1781.         already exists you will be asked whether the new information
  1782.         should overwrite the current contents of the file, be
  1783.         appended to the current contents of the file, or whether you
  1784.         would rather specify another file name or cancel the
  1785.         operation.  If there is no currently marked area you will
  1786.         be asked whether you want to write the entire buffer to the
  1787.         file.
  1788.         Note: You may also use Alt-W to write the buffer or marked
  1789.         area to a disk file.
  1790.  
  1791.  
  1792.  
  1793.       F. Protocol Status Display
  1794.  
  1795.     During an XModem, XModem1K, YModem, YModem-G, or ZModem file
  1796.   transfer, TE/2 maintains a dialog box on screen which keeps you
  1797.   informed of the current status of the file transfer.  The dialog
  1798.   title (shown here as "ZModem Download") will indicate the actual
  1799.   protocol and function in use.
  1800.  
  1801.  
  1802.         ┌──────────────────────────────────────────────┐
  1803.         │               ZModem Download                │
  1804.         │                                              │
  1805.         │         File Name:                           │
  1806.         │         File Size:                           │
  1807.         │ Bytes Transferred:                           │
  1808.         │      Packet/Block:                           │
  1809.         │    Estimated Time:                           │
  1810.         │      Time Elapsed:                           │
  1811.         │  Percent Complete:                           │
  1812.         │ Characters/Second:                           │
  1813.         │      Last Message:                           │
  1814.         │                                              │
  1815.         └──────────────────────────────────────────────┘
  1816.                            Figure GG.
  1817.                    File Transfer Status Dialog
  1818.  
  1819.  
  1820.       File Name
  1821.         This will display the name of the file currently in transit.
  1822.         If the name of the file is longer than the space allowed, it
  1823.         is abbreviated by removing characters from the beginning of
  1824.         the file name allowing the most significant part of the name
  1825.         to be displayed.  If the file name has been abbreviated, you
  1826.         will notice three dots ("...") as the first three characters
  1827.         displayed in the file name.
  1828.         On an upload, the entire path/name of the file as you had
  1829.         previously specified will be shown, including the drive
  1830.         and/or path if they were given.  The path information is for
  1831.         display only, if the protocol is one wherein the file name is
  1832.         sent to the receiver, be assured that the drive and path
  1833.         information is removed before the file name is sent to the
  1834.         remote system.
  1835.  
  1836.       File Size
  1837.         If the total file size is available, it will be displayed
  1838.         here.  This will be available on any upload and on YModem,
  1839.         YModem-G, and ZModem downloads.
  1840.  
  1841.       Bytes Transferred
  1842.         This will record the total number of bytes transferred for
  1843.         this file thus far.
  1844.  
  1845.       Packet/Block
  1846.         All of the file transfer protocols send the information from
  1847.         the sender to the receiver in packets or blocks.  The packets
  1848.         vary in size from one protocol to the other; however this
  1849.         line will keep a count of each packet as it is sent.
  1850.  
  1851.       Estimated Time
  1852.         Initially, this is a rough estimate of the time (in minutes
  1853.         and seconds) which it will take to transmit or receive the
  1854.         file.  If the total file size if not known (as in an XModem
  1855.         or XModem-1K download) this will be impossible to estimate.
  1856.         The method used for computing the initial value is:
  1857.              (((total file size) * 8) / (current baud)) * 0.75
  1858.         After the transfer has progressed for at least ten seconds,
  1859.         TE/2 will begin to recalculate this value based on the actual
  1860.         rate of transfer and will redisplay the new value each time
  1861.         a packet is sent or received.
  1862.  
  1863.       Time Elapsed
  1864.         This records the total time in minutes and seconds that have
  1865.         passed during the transfer thus far.
  1866.  
  1867.       Percent Complete
  1868.         This is simply the Bytes Transferred divided by File Size made
  1869.         into a percentage.  If the File Size is unknown (as in an
  1870.         XModem or XModem-1K download) this value will be unknown.
  1871.  
  1872.       Characters/Second
  1873.         This is simply the Bytes Transferred divided by Time Elapsed.
  1874.         
  1875.       Last Message
  1876.         This is an indicator of the latest "interesting event" that
  1877.         has transpired during the transfer.  It may contain such
  1878.         messages as "TRANSMIT BLOCK" or "RECEIVE FILE" or "BAD CRC
  1879.         OR CHECKSUM".
  1880.  
  1881.  
  1882.     Note on CompuServe B Plus Protocol
  1883.  
  1884.     Do not be alarmed if you see what appears to be erratic behavior
  1885.   of the numbers which appear in some of the numeric fields of the
  1886.   Protocol Status Display during a CompuServe B Plus file transfer.
  1887.   CompuServe and the local protocol driver re-negotiate during the
  1888.   course of the transfer, the estimated times are recalculated at
  1889.   odd intervals, and the Bytes Transferred field will alternately
  1890.   display the number of bytes received and the number of bytes trans-
  1891.   mitted.  Due to the difference in character between the status
  1892.   reporting for this protocol with respect to the X-Y-ZModem family
  1893.   of protocols, future versions of TE/2 will provide a dedicated
  1894.   status display for the CompuServe protocol.
  1895.  
  1896.  
  1897.   -------------------------------------------------------------
  1898.  
  1899.  
  1900. VIII. Customization
  1901.  
  1902.     In the preceding sections we have used the phrase "by default"
  1903.   or "default behavior" quite a few times.  Just about as often we
  1904.   have mention that such and such feature can be modified and
  1905.   referred you here.  An attempt has been made to make TE/2 as user
  1906.   configurable as possible.  Let us examine the different methods
  1907.   we have available to us for modifying TE/2's "default" behavior.
  1908.  
  1909.       A. TE2.INI
  1910.  
  1911.     When TE/2 begins it looks around for a file with the name
  1912.   "TE2.INI".  It looks first in the current directory, if it is not
  1913.   found there it looks in the directory that contains the currently
  1914.   executing copy of TE/2.  If it's not there then it looks in each
  1915.   directory referred to in the OS/2 environment setting for "PATH"
  1916.   the same as OS/2 searches for a file to execute when you type its
  1917.   name at the command line prompt.  If it finishes this process and
  1918.   still hasn't located TE2.INI, TE/2 will have no choice but to
  1919.   print an error message and exit.
  1920.  
  1921.     The TE2.INI is a flat text file that can be edited with the OS/2
  1922.   system editor or with your favorite text editor.  If you use a word
  1923.   processor to edit this file you must be sure to resave the file in
  1924.   straight ascii format, not in the word processor's document format.
  1925.   Consult the documentation for your word processor if you are unsure
  1926.   of how to do this.
  1927.  
  1928.     Most every line in TE2.INI will have a variable name and a value
  1929.   for the variable.  Certain lines or parts of lines may be used for
  1930.   commenting the file to make it more readable.  Any text on any line
  1931.   which begins with a semicolon (";") is considered a comment when
  1932.   TE/2 reads the file and will not be interpreted as a command.  You
  1933.   may have blank lines in the file, they are ignored.  You must have
  1934.   at least one space or tab between the variable and its value but
  1935.   you may also have as many as you like.  In the same vein, spaces
  1936.   or tabs on a line before the variable name or after the value are
  1937.   likewise ignored.  For a simple example, refer to Figure HH.  In
  1938.   this example, the first two lines are comments, the third, blank
  1939.   line is ignored.  In the fourth line the variable "baud" is set to
  1940.   the value "2400" and a clarifying comment ends the line.
  1941.  
  1942.     Note that the entries in TE2.INI are not case sensitive.  That is
  1943.   the example could have used "Baud" or "BAUD" instead of "baud" and
  1944.   the results would be the same.
  1945.  
  1946.  
  1947.         ---------------------------------------------------------
  1948.  
  1949.                 ; This is a very simple TE/2
  1950.                 ; initialization file
  1951.  
  1952.                 baud    2400    ; This sets default baud to 2400
  1953.                 parity  None    ; and parity to "N"
  1954.  
  1955.         ---------------------------------------------------------
  1956.                             Figure HH.
  1957.                          TE2.INI Example
  1958.  
  1959.  
  1960.     There are a very large number of variables which may be set in
  1961.   the TE2.INI file.  They control nearly every aspect of how TE/2
  1962.   will operate.  Many of these you will never need to adjust, a few
  1963.   you will probably set once and forget.  Though there are a lot
  1964.   of variables to deal with, they fall into several broad groups
  1965.   that have some things in common.  These groups are:
  1966.  
  1967.       True/False variables
  1968.         These may have one of two values: "True" or "False".  If
  1969.         you prefer, "Yes" and "No" can be used instead of "True"
  1970.         and "False".  You can mix and match the two styles.
  1971.  
  1972.       Numeric variables
  1973.         These variables expect a number for a value.  Sometimes
  1974.         there is a minimum and/or maximum value for the variable
  1975.         or the value may only be taken from a well defined list
  1976.         of possible values.  This will be indicated for each
  1977.         individual variable in the section below.  The numbers
  1978.         must be integer values in standard decimal (base 10)
  1979.         notation.
  1980.  
  1981.       Path Name variables
  1982.         Sometimes a file name, sometimes just a path is required
  1983.         for these.  Paths may be fully specified or relative,
  1984.         the drive indicator may be omitted if it is not needed.
  1985.         You may freely use the forward slash ("/") as a subdirectory
  1986.         separator instead of the backslash ("\") if you prefer.
  1987.         Some of the path variables will be checked for existence
  1988.         when TE2.INI is read and a warning will be printed on the
  1989.         screen if the path does not exist.
  1990.  
  1991.       Modem String variables
  1992.         Modem string variables are for specifying the commands that
  1993.         will be sent to your modem, i.e., "ATDT" for the dialing
  1994.         command.  There are several problems that arise when
  1995.         specifying these strings however:
  1996.           1) They may need to contain a space character which is
  1997.              usually a token delimiter.
  1998.           2) They may need to contain a semicolon character which
  1999.              usually introduces a comment.
  2000.           3) They may need to contain control characters, such as
  2001.              a carriage return character which is impossible to
  2002.              enter into the file without ending the line.
  2003.         Here are the ways to deal with these problems:
  2004.           1) If you need to enter a space character, use an
  2005.              underscore character ("_") instead.  If you really
  2006.              need an underscore, use two of them.
  2007.           2) If you need to enter a semicolon, use an exclamation
  2008.              point ("!") instead.  If you really need an exclamation
  2009.              point, use two of them.
  2010.           3) If you need to enter a control character, use standard
  2011.              "^n" notation.  For instance, if you need a carriage
  2012.              return character you would use "^M" (because the
  2013.              carriage return is ascii code 13 and "M" is the 13th
  2014.              letter in the English alphabet).  A few of the most
  2015.              important conversions are given here:
  2016.                 ^@ -- character  0, a NUL character
  2017.                 ^G -- character  7, a bell or beep
  2018.                 ^H -- character  8, a backspace
  2019.                 ^I -- character  9, a tab character
  2020.                 ^J -- character 10, a line feed character
  2021.                 ^M -- character 13, a carriage return character
  2022.                 ^[ -- character 27, an escape character
  2023.               If you need to enter a "^" character, use two of them.
  2024.         There is one other important character that may be placed
  2025.         into a modem string.  This is the delay character, usually
  2026.         the tilde ("~") but even this may be changed within TE2.INI
  2027.         (see variable "ModemDelayChar").  This character will result
  2028.         in a short delay (usually 0.5 seconds but also settable via
  2029.         the variable "ModemDelayChar") when the string is sent to the
  2030.         modem.
  2031.  
  2032.       Color Attribute variables
  2033.         These variables determine the colors that TE/2 will use to
  2034.         display its various screens.  Each is a number from zero to
  2035.         255 and may be expressed in either decimal or hexadecimal
  2036.         notation.  There are eight different colors to choose from;
  2037.         however, foreground colors may be selected to be in either
  2038.         normal or high intensity.  If you run a full screen session,
  2039.         you can make foreground characters blink, if you run in a VIO
  2040.         window you can choose the background to be either normal or
  2041.         high intensity.
  2042.         These are the eight available colors and their associated
  2043.         numbers:
  2044.                 Black   0
  2045.                 Blue    1
  2046.                 Green   2
  2047.                 Cyan    3
  2048.                 Red     4
  2049.                 Magenta 5
  2050.                 Brown   6
  2051.                 White   7
  2052.         To specify a high intensity color, add eight to the value.
  2053.         Thus, high-intensity blue is number 9.  Note that high-
  2054.         intensity brown becomes yellow.
  2055.         To formulate a color attribute, you just combine the
  2056.         color numbers for both the foreground and background into
  2057.         one number.  Do this by taking the background number,
  2058.         multiply it by sixteen and add to it the foreground color.
  2059.           Example: We want light blue on black.  Light blue is
  2060.           color 9, black is color 0 (black is always the easiest
  2061.           background to use).  (16 * 0) + 9 = 9 (or, in hex notation
  2062.           (0x09).
  2063.           Example: We want light cyan on a blue background. Light
  2064.           cyan is color number 11, blue is 1. (16 * 1) + 11 = 27
  2065.           (or 0x1b in hex notation).
  2066.         If you add 128 to the resulting value, you will get either
  2067.         blinking foreground (in a full screen session) or high
  2068.         intensity background (in a VIO window).
  2069.         Or you may use the following chart.  To use the chart, find
  2070.         the color you want for the foreground along the top and find
  2071.         the color you want for the background along the side.  The
  2072.         number on the chart where that line and column intersect is
  2073.         the number for normal foreground and normal background.  If you
  2074.         want high intensity foreground, add eight.  If you want
  2075.         blinking foreground (full screen) or high intensity back-
  2076.         ground (VIO window) add 128.
  2077.  
  2078.              Black  Blue   Green  Cyan   Red    Magnt  Brown  White
  2079.             +-------------------------------------------------------
  2080.     Black   |   0     1      2      3      4      5      6      7
  2081.     Blue    |  16    17     18     19     20     21     22     23
  2082.     Green   |  32    33     34     35     36     37     38     39
  2083.     Cyan    |  48    49     50     51     52     53     54     55
  2084.     Red     |  64    65     66     67     68     69     70     71
  2085.     Magenta |  80    81     82     83     84     85     86     87
  2086.     Brown   |  96    97     98     99    100    101    102    103
  2087.     White   | 112   113    114    115    116    117    118    119
  2088.  
  2089.  
  2090.       Enumerated Value variables
  2091.         Some variables have only a relatively small range of values
  2092.         to choose from.  One example of this is "WordLen" which may
  2093.         only take the values 7 or 8.  Another is "CtsRts" which may
  2094.         only take the values "cts", "rts", "both", or "neither".
  2095.         Variables of this type will be dealt with individually.
  2096.  
  2097.       Other variables
  2098.         And then there are the several that don't quite fit into any
  2099.         of these pigeon holes.  An example of this would be
  2100.         "AsciiUL" which takes a list of parameters delimited by
  2101.         commas.  The thing to remember here is that the space
  2102.         character is still a token delimiter so there must be no
  2103.         embedded spaces in these parameter strings.  For example,
  2104.         "ULPrtyClass" takes two parameters,
  2105.                 ULPrtyClass     fixedhigh,0
  2106.         is a valid entry for this variable,
  2107.                 ULPrtyClass     fixedhigh, 0
  2108.         is not.
  2109.  
  2110.  
  2111.     The following is a list of all of the variables you may set in
  2112.   TE2.INI arranged by major function.  For both this list and the
  2113.   alphabetized one following you should note that the default value
  2114.   listed here is the default if the variable DOES NOT APPEAR in the
  2115.   TE2.INI file at all.  TE/2 is distributed with an example TE2.INI
  2116.   which changes the values of some of these variables.
  2117.  
  2118.  
  2119.   Initialization Variables by Major Function
  2120.   =========================================
  2121.  
  2122.     Comm Port Settings
  2123.     ==================
  2124.  
  2125.         Variable        Default
  2126.         ========        =======
  2127.  
  2128.         Baud            2400
  2129.           Type:  numeric, must be a valid baud rate
  2130.           Notes: this will become the default baud rate when TE/2
  2131.                   first enters terminal mode.
  2132.  
  2133.         BreakLen        1000ms
  2134.           Type:  numeric, greater than zero
  2135.           Notes: Break signal duration in milliseconds
  2136.  
  2137.         CtsRts          BOTH
  2138.           Type:  enumeration, CTS, RTS, BOTH, or NEITHER
  2139.  
  2140.  
  2141.         Device          com1
  2142.           Type:  simple string, rules for modem strings apply
  2143.           Notes: The "Device" parameter may override any "Port"
  2144.                  parameter given in the file.  You do not have
  2145.                  to specify "com1", "com2", et cetera if your
  2146.                  comm device has another name however the Alt-I
  2147.                  information display will not match the reality
  2148.                  when you use the "Device" parameter unless it
  2149.                  is named "com1", "com2", etc., and the "Port"
  2150.                  parameter is set to match.
  2151.  
  2152.         Parity          N
  2153.           Type:  enumerated, must be N, O, E, M, or S
  2154.           Notes: this will become the default parity when TE/2
  2155.                  first enters terminal mode.
  2156.  
  2157.         Port            1
  2158.           Type:  numeric, must be 1, 2, ..., 8
  2159.           Notes: If your comm device is named "comX" where X is
  2160.                  a number from 1 to 8, you do not need to use
  2161.                  the "Device" parameter (above) and may simply
  2162.                  specify the port number.
  2163.  
  2164.         StopBits        1
  2165.           Type:  enumerated, must be 1, 1.5, or 2
  2166.           Notes: this will become the default number of stop bits
  2167.                  when TE/2 enters terminal mode.
  2168.  
  2169.         WordLen         8
  2170.           Type:  numeric, must be 7 or 8
  2171.           Notes: this will become the default word length when TE/2
  2172.                  first enters terminal mode.
  2173.  
  2174.         XonXoff         NEITHER
  2175.           Type:  enumerated, NEITHER, TRANSMIT, RECEIVE, or BOTH
  2176.  
  2177.  
  2178.     Terminal Settings
  2179.     =================
  2180.  
  2181.         Variable        Default
  2182.         ========        =======
  2183.  
  2184.         alarmPopUp      false
  2185.           Type:  true/false
  2186.           Notes: enables/disable alarm pop-up screens.  Further,
  2187.                  note that the alarm pop-up will only ever be
  2188.                  displayed if TE/2 is not the foreground task
  2189.                  at the time of the alarm.
  2190.  
  2191.         alarmTime       2 secs
  2192.           Type:  numeric, must be greater than or equal to zero
  2193.           Notes: Alarm duration in seconds, zero disables the alarm
  2194.  
  2195.         AlarmType       CHIME
  2196.           Type:  enumerated: NONE, CHIME, or BUZZER
  2197.           Notes: Determines how the alarm will sound
  2198.  
  2199.         chatBuffered    true 
  2200.           Type:  true/false
  2201.           Notes: entry value for chat mode buffering
  2202.  
  2203.         colorLock       false
  2204.           Type:  true/false
  2205.           Notes: if true the terminal color cannot be changed via
  2206.                  ANSI codes from the remote
  2207.  
  2208.         clsReset        false
  2209.           Type:  true/false
  2210.           Notes: if set to true, the current color attribute for
  2211.                  the terminal screen will be set to the default
  2212.                  (see TermAttr) when a clear-screen command is
  2213.                  issued (either via Alt-C or by a terminal code).
  2214.                  Otherwise the screen is clears to the current
  2215.                  attribute.
  2216.  
  2217.         dtrHangUp       true 
  2218.           Type:  true/false
  2219.           Notes: determines whether the hangup sequence also drops
  2220.                  DTR momentarily
  2221.  
  2222.         LFafterCR       false
  2223.           Type:  true/false
  2224.           Notes: entry value for LF After CR
  2225.  
  2226.         LocalEcho       false
  2227.           Type:  true/false
  2228.           Notes: entry value for Local Echo
  2229.  
  2230.         LogoDelay       8 secs
  2231.           Type:  numeric, greater than or equal to zero
  2232.           Notes: Length of time the TE/2 logo will remain on screen
  2233.                  after primary initialization has completed.  If this
  2234.                  is set to zero, the logo will not be displayed.
  2235.                  Note that in this version of TE/2 the logo display
  2236.                  is followed by a shareware notice; this notice
  2237.                  cannot be disabled.
  2238.  
  2239.         MatchBaud       true 
  2240.           Type:  true/false
  2241.           Notes: if false the dialer will not attempt to match the
  2242.                  baud rate after making a connection. Use this if
  2243.                  you need to "Lock" the baud rate for a high-speed
  2244.                  connection.
  2245.  
  2246.         MenuActive      true 
  2247.           Type:  true/false
  2248.           Notes: initial display/nondisplay of Terminal Modem menu
  2249.  
  2250.         QueryHangUp     false
  2251.           Type:  enumerated: TRUE, FALSE, IFCARRIER
  2252.           Notes: If TRUE, TE/2 will ask for verification each time
  2253.                  before hanging up or exiting.  If FALSE, TE/2 will
  2254.                  never ask for verification.  If IFCARRIER, TE/2
  2255.                  will ask only if it is currently on-line.
  2256.  
  2257.         ScreenLines     current number of screen lines
  2258.           Type:  numeric, must be greater than zero
  2259.           Notes: This sets the desired number of lines for the
  2260.                  screen.
  2261.  
  2262.         ScrollBack      250
  2263.           Type:  number, greater than or equal to zero
  2264.           Notes: Number of lines to retain in Scroll Back Buffer,
  2265.                  if this is set to zero the Scroll Back Buffer is
  2266.                  disabled.
  2267.  
  2268.  
  2269.     Emulation Settings
  2270.     ==================
  2271.  
  2272.         Variable        Default
  2273.         ========        =======
  2274.  
  2275.         Emulate         ANSI_TE2
  2276.           Type:  enumerated: TTY, ANSI, ANSI_TE2, VT100, or 3101
  2277.           Notes: defines the default terminal emulation at program
  2278.                  startup
  2279.  
  2280.         enqReply        NULL
  2281.           Type:  modem string
  2282.           Notes: in VT100 mode, this string will be sent to the
  2283.                  remote system in response to an ENQ character
  2284.  
  2285.         AutoNL3101      FALSE
  2286.           Type:  true/false
  2287.           Notes: simulates the setting of Switch 31, the AUTO NL
  2288.                  switch on the IBM 3101.  If true, the cursor will
  2289.                  move to the first position on the next line after
  2290.                  displaying a character in column 80
  2291.  
  2292.         AutoLF3101      FALSE
  2293.           Type:  true/false
  2294.           Notes: simulates the setting of Switch 32, the AUTO LF
  2295.                  switch on the IBM 3101.  If true, the cursor will
  2296.                  react to a CR as if it were a CR-LF pair.
  2297.  
  2298.         Scroll3101      TRUE
  2299.           Type:  true/false
  2300.           Notes: simulates the setting of Switch 34, the SCROLL
  2301.                  switch on the IBM 3101.  If set to false, scrolling
  2302.                  is disabled.
  2303.  
  2304.         EndChar3101     CR
  2305.           Type:  enumerated: ETX, CR, EOT, XOFF
  2306.           Notes: simulates the settings of Switches 16 and 17 on the
  2307.                  IBM 3101.  These settings define what character will
  2308.                  be transmitted by the Enter key.
  2309.  
  2310.  
  2311.     Modem Settings
  2312.     ==============
  2313.  
  2314.         Variable        Default
  2315.         ========        =======
  2316.  
  2317.         Connect         special
  2318.           Type:  modem string(s)
  2319.           Notes: You may have up to 12 connect strings specified.
  2320.                  These are the actual strings that TE/2's dialer
  2321.                  will look for from the modem when it dials. Each
  2322.                  string follows the rules for modem strings given
  2323.                  above and is followed by a comma and a baud rate
  2324.                  which will be used for purposes of baud matching
  2325.                  if you have MatchBaud set on.
  2326.           Example:  This is an example of setting several connect
  2327.                     strings in TE2.INI:
  2328.  
  2329.                         Connect  CONNECT^M,300
  2330.                         Connect  CONNECT_1200,1200
  2331.                         Connect  CONNECT_2400,2400
  2332.                         Connect  CONNECT_9600/ARQ,9600
  2333.  
  2334.                   Note that if you specify any Connect strings you
  2335.                   should be sure to specify ALL Connect strings
  2336.                   you expect to encounter.  TE/2 default set covers
  2337.                   300, 1200, 2400, 4800, and 9600 for standard
  2338.                   Hayes compatible modems operating with verbal
  2339.                   response codes.  If you specify any Connect strings
  2340.                   in TE2.INI however, TE/2 assumes that you will
  2341.                   specify them all.
  2342.           Further Note: The strings are searched in order from
  2343.                   first to last and when one matches the search ends.
  2344.                   Thus, the "^M" in the first example is very
  2345.                   important!  If it were not there, any string which
  2346.                   begins with "CONNECT" (i.e., every modem connect
  2347.                   result string!) would be taken to imply 300 baud.
  2348.                   This is probably not what you had in mind.
  2349.                   Also, the third line above will match
  2350.                   "CONNECT 2400^M" as well as "CONNECT 2400/ARQ^M",
  2351.                   but the fourth line will not match "CONNECT 9600^M".
  2352.  
  2353.  
  2354.         modemAnsStrg    ATS0=1^M^J
  2355.           Type:  modem string
  2356.           Notes: this string is used to initialize auto-answer
  2357.                  mode.
  2358.           Note further: This string is not used in this version
  2359.                         of TE/2 but to ensure file compatibility
  2360.                         with the full version, it is included here.
  2361.  
  2362.         modemDelayChar  0x7e,500
  2363.           Type:  special
  2364.           Notes: The two values here are the ascii value of the
  2365.                  character to use for delays in the various modem
  2366.                  strings (0x7e is the tilde character "~") and the
  2367.                  duration of the delay in milliseconds
  2368.  
  2369.         modemDialStrg   ATDT
  2370.           Type:  modem string
  2371.           Notes: this is used as the modem dial command
  2372.  
  2373.         modemDialSufx   ^M
  2374.           Type:  modem string
  2375.           Notes: this is sent to the modem after the number in a
  2376.                  dial command
  2377.  
  2378.         modemHangStrg   ~~~+++~~ATH0^M^J
  2379.           Type:  modem string
  2380.           Notes: this string is sent to the modem to cause it to
  2381.                  hang-up the line (see also dtrHangUp)
  2382.  
  2383.         modemInitStrg   ATE0_M1_Q0_V1_X4_S7=255_S11=55_S0=0^M^J
  2384.           Type:  modem string
  2385.           Notes: this string is sent to the modem at startup for
  2386.                  initialization
  2387.  
  2388.         modemOKStrg     OK
  2389.           Type:  modem string
  2390.           Notes: this is the string that TE/2 will expect the modem
  2391.                  to return after receiving a command string
  2392.                  successfully.
  2393.  
  2394.         noConnect       special
  2395.           Type:  modem string(s)
  2396.           Notes: See also "Connect" above.  Here you may specify up
  2397.                  to 6 NoConnect strings.  These are the strings
  2398.                  which TE/2's dialer will look for when dialing to
  2399.                  signal that the dialing attempt has failed. These
  2400.                  strings follow the rules for modem strings given
  2401.                  above.  If you specify any NoConnect strings you
  2402.                  must specify every one you expect to encounter
  2403.                  because you will be replacing TE/2's default set.
  2404.  
  2405.                  TE/2's default set is:
  2406.                         NoConnect    NO_CARRIER
  2407.                         NoConnect    ERROR
  2408.                         NoConnect    NO_DIAL_TONE
  2409.                         NoConnect    BUSY
  2410.                         NoConnect    NO_ANSWER
  2411.                         NoConnect    VOICE
  2412.  
  2413.  
  2414.  
  2415.     Dialer and Dialing Directory
  2416.     ============================
  2417.  
  2418.         Variable        Default
  2419.         ========        =======
  2420.  
  2421.         AutoDirSave     false
  2422.           Type:  true/false
  2423.           Notes: if true the directory file will be saved each time
  2424.                  upon exiting the Dialing Directory.
  2425.  
  2426.         dialerTimeOut   45 secs
  2427.           Type:  numeric, greater than zero
  2428.           Notes: Amount of time in seconds that the dialer will
  2429.                  allow a phone number to ring.
  2430.  
  2431.         RedialDelay     2 sec
  2432.           Type:  numeric, greater than zero
  2433.           Notes: Amount of time in seconds that the dialer will
  2434.                  pause between dialing attempts.
  2435.  
  2436.  
  2437.     Color Attributes
  2438.     ================
  2439.  
  2440.         Variable        Default
  2441.         ========        =======
  2442.  
  2443.         ChatAttr        0x0f - Bright white on black
  2444.           Type:  attribute
  2445.           Notes: Chat Mode, Local Window text
  2446.  
  2447.         ChatRemoteAttr  0x07 - White on black
  2448.           Type:  attribute
  2449.           Notes: Chat Mode, Remote Window text
  2450.  
  2451.         ChatTitleAttr   0x70 - Black on white
  2452.           Type:  attribute
  2453.           Notes: Chat Mode, titles
  2454.                  This attribute is not used in this version of
  2455.                  TE/2 but to ensure file compatibility with the
  2456.                  full version it is included here.
  2457.  
  2458.         CmdInputAttr    0x07 - White on black
  2459.           Type:  attribute
  2460.           Notes: Command Prompt, text input, while editing
  2461.                  This attribute is not used in this version of
  2462.                  TE/2 but to ensure file compatibility with the
  2463.                  full version it is included here.
  2464.  
  2465.         CmdInputHiAttr  0x70 - Black on white
  2466.           Type:  attribute
  2467.           Notes: Command Prompt, text input, initial display of
  2468.                  default value
  2469.                  This attribute is not used in this version of
  2470.                  TE/2 but to ensure file compatibility with the
  2471.                  full version it is included here.
  2472.  
  2473.         CmdPromptAttr   0x0f - Bright white on black
  2474.           Type:  attribute
  2475.           Notes: Command Prompt, prompt
  2476.                  This attribute is not used in this version of
  2477.                  TE/2 but to ensure file compatibility with the
  2478.                  full version it is included here.
  2479.  
  2480.         DLogDaAttr      0x08 - Gray on black
  2481.           Type:  attribute
  2482.           Notes: Dialog boxes, disabled menu items
  2483.  
  2484.         DLogEdAttr      0x70 - Black on white
  2485.           Type:  attribute
  2486.           Notes: Dialog boxes, text input, while editing
  2487.  
  2488.         DLogEdHiAttr    0x0f - Bright white on black
  2489.           Type:  attribute
  2490.           Notes: Dialog boxes, text input, initial display of
  2491.                  default value
  2492.  
  2493.         DLogHiAttr      0x70 - Black on white
  2494.           Type:  attribute
  2495.           Notes: Dialog boxes, highlit text
  2496.  
  2497.         DLogNormAttr    0x0f - Bright white on black
  2498.           Type:  attribute
  2499.           Notes: Dialog boxes, normal text
  2500.  
  2501.         DialHiAttr      0x0f - Bright white on black
  2502.           Type:  attribute
  2503.           Notes: Dialing Directory, highlighted bar
  2504.  
  2505.         DialNormAttr    0x07 - White on black
  2506.           Type:  attribute
  2507.           Notes: Dialing Directory, normal text
  2508.  
  2509.         ErrorAttr       0x0f - Bright white on black
  2510.           Type:  attribute
  2511.           Notes: Error Message display
  2512.  
  2513.         LogoAttr        0x70 - Black on white
  2514.           Type:  attribute
  2515.           Notes: Terminal Screen menu, TE/2 logo
  2516.  
  2517.         MenuHiAttr      0x0f - Bright white on black
  2518.           Type:  attribute
  2519.           Notes: Terminal Screen menu, highlit text
  2520.  
  2521.         MenuNormAttr    0x07 - White on black
  2522.           Type:  attribute
  2523.           Notes: Terminal Screen menu, normal text
  2524.  
  2525.         ScrlBackAttr    0x07 - White on black
  2526.           Type:  attribute
  2527.           Notes: Scroll Back, normal text
  2528.  
  2529.         ScrlBackFdAttr  0x0f - Bright white on black
  2530.           Type:  attribute
  2531.           Notes: Scroll Back, found text
  2532.  
  2533.         ScrlBackMkAttr  0x70 - Black on white
  2534.           Type:  attribute
  2535.           Notes: Scroll Back, marked text
  2536.  
  2537.         ScrlBackTiAttr  0x70 - Black on white
  2538.           Type:  attribute
  2539.           Notes: Scroll Back, titles
  2540.  
  2541.         ShadowAttr      0x08 - Gray on black
  2542.           Type:  attribute
  2543.           Notes: Dialog boxes, shadow
  2544.  
  2545.         SnapShotAttr    0x70 - Black on white
  2546.           Type:  attribute
  2547.           Notes: SnapShot, flash attribute
  2548.  
  2549.         TermAttr        0x07 - White on black
  2550.           Type:  attribute
  2551.           Notes: Terminal Screen attribute
  2552.  
  2553.  
  2554.  
  2555.     Transfer Protocols
  2556.     ==================
  2557.  
  2558.         Variable        Default
  2559.         ========        =======
  2560.  
  2561.         AsciiUL         0,crlf,true,0,0,0,false,false,2000,2000
  2562.           Type:  special
  2563.           Notes: Here you may specify the default answers to the
  2564.                  questions posed in the Ascii Upload Dialog (see
  2565.                  "Alt-U Upload" above).  The last two fields are
  2566.                  options, all others must be specified, they must
  2567.                  be separated by commas, and there must be NO
  2568.                  extra space or tab characters in the line.
  2569.                  The fields are:
  2570.                    Prompt Char: ascii value of the prompt character
  2571.                                 you wish to use.  The value may be
  2572.                                 in decimal, hex, or octal.  Use zero
  2573.                                 to set no prompt.
  2574.                    End of Line Seq: "LF", "CR", or "CRLF"
  2575.                    Expand Blanks Lines: true or false.
  2576.                    Char Pacing: in milliseconds.
  2577.                    Line Pacing: in milliseconds.
  2578.                    Strip 8th Bit: true or false.
  2579.                    View Output: true or false.
  2580.                    Write Timeout: in milliseconds.
  2581.                    Read Timeout: in milliseconds.
  2582.  
  2583.         AutoZM          false
  2584.           Type:  true/false
  2585.           Notes: enables/disables Auto ZModem downloads
  2586.                  When enabled, TE/2 will automatically begin a ZModem
  2587.                  download whenever it receives the ZModem signature
  2588.                  from the remote system.
  2589.  
  2590.         ClobberDL       SALVAGE
  2591.           Type:  enumerated: TRUE, FALSE, or SALVAGE
  2592.           Notes: This controls what TE/2 will do when you attempt to
  2593.                  download a file with a file of the same name already
  2594.                  in existence in the download directory of your disk.
  2595.                  If set to TRUE, the new file will overwrite (clobber)
  2596.                  the old file, if set to FALSE it will abort the
  2597.                  transfer and issue an error message.  If set to
  2598.                  SALVAGE, it will attempt to rename the existing file
  2599.                  before beginning to write the new file.  It does
  2600.                  this by replacing characters in the file name,
  2601.                  starting at the end of the name, with dollar sign
  2602.                  characters until it finds a name that does not already
  2603.                  exist.
  2604.  
  2605.         downloadPath    NULL
  2606.           Type:  path name
  2607.           Notes: specifies the directory you wish all downloaded
  2608.                  files to be placed in.  If left NULL, the current
  2609.                  directory is used.  For XModem and XModem-1K you
  2610.                  may override this setting by specifying a drive or
  2611.                  a path when prompted for the file name.
  2612.  
  2613.         DLPrtyClass     FIXEDHIGH,0
  2614.           Type:  special
  2615.           Notes: specifies the priority you wish OS/2 to give the
  2616.                  download file transfer protocols while they are
  2617.                  doing their duties.  TE/2 normally operates at the
  2618.                  default priority level but if the DLPrtyClass is
  2619.                  set to anything other than "NORMAL" it will adjust
  2620.                  the priority level accordingly for the duration of
  2621.                  the file transfer and restore normal priority upon
  2622.                  return.  Valid values for the first parameter of
  2623.                  DLPrtyClass are: "NORMAL", "FIXEDHIGH", or
  2624.                  "TIMECRITICAL".  The second parameter is called a
  2625.                  priority delta, it may be in the range of -31 to 31
  2626.                  and it may be omitted with no ill effects.
  2627.           Further Notes: If you set the priority class to NORMAL you
  2628.                  may very well experience timeout errors during your
  2629.                  file transmissions especially if your computer is
  2630.                  busy with other tasks while the file is transferring.
  2631.                  One the other hand, if you leave it at the default
  2632.                  value of FIXEDHIGH and are still experiencing these
  2633.                  problems you might want to set TIMECRITICAL although
  2634.                  the response and throughput of all other processes
  2635.                  running on your computer during the transfer will
  2636.                  become noticeably slower.
  2637.  
  2638.         ULPrtyClass     FIXEDHIGH,0
  2639.           Type:  special
  2640.           Notes: See DLPrtClass above for a full discussion of how to
  2641.                  set this variable.  ULPrtyClass affects upload file
  2642.                  transfers in exactly the same manner as DLPrtyClass
  2643.                  affects downloads.
  2644.  
  2645.         uploadPath      NULL
  2646.           Type:  path name
  2647.           Notes: This is where TE/2 will look for a file that does
  2648.                  not have a drive or path specified explicitly in
  2649.                  its name.  If left to NULL this will be the current
  2650.                  directory.
  2651.  
  2652.  
  2653.     Misc File and Path Specs
  2654.     ========================
  2655.  
  2656.         Variable        Default
  2657.         ========        =======
  2658.  
  2659.         CallLog         NULL
  2660.           Type:  path name
  2661.           Notes: If this file name is specified, TE/2 will write
  2662.                  information about each outgoing phone call it
  2663.                  makes.  The information is the Name from the
  2664.                  directory entry (or the number for a manual dial),
  2665.                  the time the call began, the time it ended, and
  2666.                  the total call duration.  This is handy for what-
  2667.                  ever record keeping you need to do whether it's
  2668.                  for tax purposes or just to keep the phone company
  2669.                  honest.
  2670.  
  2671.         SnapShot        te2snap.sht
  2672.           Type:  path name
  2673.           Notes: This specifies the name of the snapshot file (see
  2674.                  "Alt-S SnapShot" above).
  2675.  
  2676.         logPath         NULL
  2677.           Type:  path name
  2678.           Notes: This is where TE/2 will place all log files (see
  2679.                  "Alt-L LogFile") unless you specify a name with
  2680.                  an explicit drive or path when prompted for a
  2681.                  log file name.
  2682.  
  2683.         scriptPath      NULL
  2684.           Type:  path name
  2685.           Notes: This is the directory where all script files are
  2686.                  expected to be located.
  2687.                  This variable is not used in this version of
  2688.                  TE/2 but to ensure file compatibility with the
  2689.                  full version it is included here.
  2690.                  
  2691.  
  2692.         ShellCmd        cmd.exe NULL
  2693.           Type:  special
  2694.           Notes: This specifies the name of the program which is to
  2695.                  be executed when you use the Alt-O key (see "Alt-O
  2696.                  Shell to OS/2" above).  The program name should be
  2697.                  a complete path/spec and contain the file extension
  2698.                  (".exe", etc.).  If parameters are needed they may
  2699.                  be specified after one or more white space
  2700.                  characters (space or tab).  The parameter string
  2701.                  follows the rules for modem strings given above.
  2702.                  That is, space characters must be replaced with
  2703.                  underscores, et cetera.
  2704.                  Note that to execute a batch file (".cmd") you must
  2705.                  use the syntax:
  2706.                         ShellCmd  cmd.exe /c_cmdfilename
  2707.  
  2708.  
  2709.  
  2710.  
  2711.     What follows now is a list of all valid variables for the TE2.INI
  2712.   file given in alphabetical order.  For each variable is listed the
  2713.   variable type ("True/False", "Color Attribute", etc.) and the
  2714.   section where you may find the more complete description of the
  2715.   variable in the functional listing above.
  2716.  
  2717.  
  2718.  
  2719.   Initialization Variables - Alphabetical list
  2720.   ===========================================
  2721.  
  2722.  
  2723.         Variable        Type                    Section
  2724.         ========        ====                    =======
  2725.         AlarmPopUp      True/False              Terminal Settings
  2726.         AlarmTime       Numeric                 Terminal Settings
  2727.         AlarmType       Enumeration             Terminal Settings
  2728.         AsciiUL         Special                 Transfer Protocols
  2729.         AutoDirSave     True/False              Dialer and Dialing Directory
  2730.         AutoLF3101      True/False              Emulation Settings
  2731.         AutoNL3101      True/False              Emulation Settings
  2732.         AutoZM          True/False              Transfer Protocols
  2733.         Baud            Enumeration             Comm Port Settings
  2734.         BreakLen        Numeric                 Comm Port Settings
  2735.         CallLog         Path String             Misc File and Path Specs
  2736.         ChatAttr        Color Attribute         Color Attributes
  2737.         ChatBuffered    True/False              Terminal Settings
  2738.         ChatRemoteAttr  Color Attribute         Color Attributes
  2739.         ChatTitleAttr   Color Attribute         Color Attributes
  2740.         ClobberDL       Enumeration             Transfer Protocols
  2741.         ClsReset        True/False              Terminal Settings
  2742.         CmdInputAttr    Color Attribute         Color Attributes
  2743.         CmdInputHiAttr  Color Attribute         Color Attributes
  2744.         CmdPromptAttr   Color Attribute         Color Attributes
  2745.         ColorLock       True/False              Terminal Settings
  2746.         Connect         Modem String/Special    Modem Settings
  2747.         CtsRts          Enumeration             Comm Port Settings
  2748.         DLPrtyClass     Special                 Transfer Protocols
  2749.         DLogDaAttr      Color Attribute         Color Attributes
  2750.         DLogEdAttr      Color Attribute         Color Attributes
  2751.         DLogEdHiAttr    Color Attribute         Color Attributes
  2752.         DLogHiAttr      Color Attribute         Color Attributes
  2753.         DLogNormAttr    Color Attribute         Color Attributes
  2754.         Device          String                  Comm Port Settings
  2755.         DialHiAttr      Color Attribute         Color Attributes
  2756.         DialNormAttr    Color Attribute         Color Attributes
  2757.         DialerTimeOut   Numeric                 Dialer and Dialing Directory
  2758.         DownloadPath    Path String             Transfer Protocols
  2759.         DtrHangUp       True/False              Terminal Settings
  2760.         Emulate         Enumeration             Emulation Settings
  2761.         EndChar3101     Enumeration             Emulation Settings
  2762.         EnqReply        Modem String            Modem Settings
  2763.         ErrorAttr       Color Attribute         Color Attributes
  2764.         LFafterCR       True/False              Terminal Settings
  2765.         LocalEcho       True/False              Terminal Settings
  2766.         LogPath         Path String             Misc File and Path Specs
  2767.         LogoAttr        Color Attribute         Color Attributes
  2768.         LogoDelay       Numeric                 Terminal Settings
  2769.         MatchBaud       True/False              Terminal Settings
  2770.         MenuActive      True/False              Terminal Settings
  2771.         MenuHiAttr      Color Attribute         Color Attributes
  2772.         MenuNormAttr    Color Attribute         Color Attributes
  2773.         ModemAnsStrg    Modem String            Modem Settings
  2774.         ModemDelayChar  Special                 Modem Settings
  2775.         ModemDialStrg   Modem String            Modem Settings
  2776.         ModemDialSufx   Modem String            Modem Settings
  2777.         ModemHangStrg   Modem String            Modem Settings
  2778.         ModemInitStrg   Modem String            Modem Settings
  2779.         ModemOKStrg     Modem String            Modem Settings
  2780.         NoConnect       Modem String/Special    Modem Settings
  2781.         Parity          Enumeration             Comm Port Settings
  2782.         Port            Enumeration             Comm Port Settings
  2783.         QueryHangUp     Enumeration             Terminal Settings
  2784.         RedialDelay     Numeric                 Dialer and Dialing Directory
  2785.         ScreenLines     Numeric                 Terminal Settings
  2786.         ScriptPath      Path String             Misc File and Path Specs
  2787.         ScrlBackAttr    Color Attribute         Color Attributes
  2788.         ScrlBackFdAttr  Color Attribute         Color Attributes
  2789.         ScrlBackMkAttr  Color Attribute         Color Attributes
  2790.         ScrlBackTiAttr  Color Attribute         Color Attributes
  2791.         Scroll3101      True/False              Emulation Settings
  2792.         ScrollBack      Numeric                 Terminal Settings
  2793.         ShadowAttr      Color Attribute         Color Attributes
  2794.         ShellCmd        Path String/Special     Misc File and Path Specs
  2795.         SnapShot        Path String             Misc File and Path Specs
  2796.         SnapShotAttr    Color Attribute         Color Attributes
  2797.         StopBits        Enumeration             Comm Port Settings
  2798.         TermAttr        Color Attribute         Color Attributes
  2799.         ULPrtyClass     Special                 Transfer Protocols
  2800.         UploadPath      Path String             Transfer Protocols
  2801.         WordLen         Enumeration             Comm Port Settings
  2802.         XonXoff         Enumeration             Comm Port Settings
  2803.  
  2804.  
  2805.       B. TE/2 Command Line
  2806.  
  2807.     There are several command line parameters which you may specify
  2808.   for TE/2.  In most cases, these parameters specify values which
  2809.   are also definable in the TE2.INI file.  In these cases, the
  2810.   command line parameter will override the value set in the
  2811.   initialization file.
  2812.  
  2813.     Each command line parameters must begin with a slash ("/") or a
  2814.   dash ("-") followed by a one letter "switch".  Each switch itself
  2815.   (except "-v") takes a parameter which must follow directly with no
  2816.   intervening whitespace.  You may use either upper or lower case
  2817.   letters for the switches.
  2818.  
  2819.       -b<baud>       - startup baud rate
  2820.       -c<comport>    - commport (1 thru 8) to use
  2821.       -f<filename>   - name of alternate TE2.INI file, this may
  2822.                         be any valid OS/2 file name with or
  2823.                         without a path.  If this parameter is
  2824.                         present the specified file will be read
  2825.                         instead of TE2.INI.
  2826.       -h<handle>     - open comm device handle.  Use this if
  2827.                         you are executing TE/2 as a child of a
  2828.                         process which already has the comm port
  2829.                         open.
  2830.       -m<scriptfile> - startup script file.  Note, this switch
  2831.                         is not used in the current version of
  2832.                         TE/2 but for compatibility with the
  2833.                         full version, it will not cause a syntax
  2834.                         error if it is present.
  2835.       -p<parity>     - startup parity (N, O, E, M, or S)
  2836.       -s<stopbits>   - startup stopbits (1, 1.5, or 2)
  2837.       -w<wordlen>    - startup word length (7 or 8)
  2838.       -v             - print copyright, version, and date information
  2839.                         and immediately exit (TE/2 is not run).
  2840.  
  2841.  
  2842.  
  2843.       C. Starting TE/2 from Presentation Manager
  2844.  
  2845.     Because of the divergent methods of adding a program to the OS/2
  2846.   DeskTop between the various versions of OS/2 you are directed to
  2847.   your OS/2 documentation for a full discussion exactly how to do
  2848.   this on your computer with your version of OS/2.  We should make
  2849.   some notes here however.
  2850.  
  2851.     o  TE/2 should be installed as either a Full Screen application
  2852.        or as a Windowed Application.  It CANNOT (and should not) be
  2853.        installed as a Presentation Manager Application.  You will
  2854.        find that you get the best response from TE/2 if you run it
  2855.        in Full Screen mode however.
  2856.  
  2857.     o  Some icon files that are created for OS/2 1.2 are not
  2858.        compatible with OS/2 version 1.1.  There are two icon files
  2859.        supplied with TE/2, the file names are TE2_11.ICO and
  2860.        TE2_12.ICO.  TE2_11.ICO is a black and white icon and may
  2861.        be used with any version of OS/2 (and on and display monitor).
  2862.        TE2_12.ICO is a color icon and should be used under OS/2
  2863.        version 1.2 only.  This icon may not work if you do not have
  2864.        at least VGA resolution on your monitor.
  2865.  
  2866.     o  To install the icon simply rename the appropriate file TE2.ICO
  2867.        and place it in the same directory with TE2.EXE.  If you have
  2868.        the wrong icon file the Presentation Manager will refuse to
  2869.        run TE/2 (with a message about possibly not having enough
  2870.        memory to run the program).  If this happens, use the other
  2871.        icon file.
  2872.  
  2873.     o  After this you should be able to execute TE/2 by clicking on
  2874.        its name in the Start Programs or Group menu.  If you start
  2875.        TE/2 from the File Manager (again, by clicking on its name
  2876.        or icon), TE/2 will startup in Windowed mode.
  2877.  
  2878.  
  2879.  
  2880.  
  2881.       D. TE2.XEX
  2882.  
  2883.     There can be any number on entries in the user programs file,
  2884.   only the first eight are used however. The default file name is
  2885.   "te2.xex".  Each entry uses four lines and is of the form:
  2886.  
  2887.         procflags[,execflags]
  2888.         Program Title
  2889.         Executable File Name
  2890.         Parameters
  2891.  
  2892.   procflags are:
  2893.         one of:
  2894.                 DosExecPgm      = 0x0001
  2895.                 DosStartSession = 0x0002
  2896.         ORed with one of:
  2897.                 FOREGROUND      = 0x0010
  2898.                 BACKGROUND      = 0x0020
  2899.         ORed with:
  2900.                 CHILDSESSION    = 0x0100
  2901.  
  2902.   execflags is zero if absent else it may be one or more of:
  2903.                 SaveScreen      = 0x0001
  2904.                 Pause on return = 0x0002
  2905.  
  2906.     "CHILDSESSION" is only valid with DosStartSession, it is ignored
  2907.   otherwise. execflags are only valid with a FOREGROUND, DosExecPgm
  2908.   entry, they are ignored otherwise.
  2909.     procflags and execflags may be expressed in decimal, octal, or hex.
  2910.   Use standard 'C' syntax, i.e., 27 == 033 == 0x001b == 27 decimal.
  2911.   Number bases can be intermixed from number to number.
  2912.  
  2913.     "Program Title" should not be more than 32 characters long; TE/2 
  2914.   does not check the length.  This is the title that will appear on TE/2
  2915.   User Programs menu and, if the entry is a Session type entry, it will
  2916.   also appear on the Task Manager list and the sessions window if it
  2917.   has one.
  2918.  
  2919.     "Executable File Name" is just that.  It must have an extension 
  2920.   (.exe or .com) and it may have an explicit drive/path.  If it does not 
  2921.   have an explicit drive/path, the PATH environment variable will be 
  2922.   searched for the executable.  Batch files (.cmd) may not be executed 
  2923.   directly.  To execute a batch file, specify CMD.EXE as the executable 
  2924.   file name and "/c batchfilename" in the parameters field.  For session 
  2925.   type entries, OS/2 will decided, based on the exefile header, whether 
  2926.   to run the session full screen, in a vio window, or as a PM app.
  2927.  
  2928.     "Parameters" specifies the command line to send to the executed
  2929.   program.  There are a number of special variables that may be
  2930.   embedded anywhere in the command line allowing you to use some of
  2931.   TE/2's internal values and/or user inputs. A summary follows. Note
  2932.   that the characters used here ARE case sensitive.
  2933.  
  2934.         %h == open commport handle
  2935.         %c == open commport name
  2936.         %n == open commport number
  2937.         %b == current baud
  2938.         %p == current parity
  2939.         %w == current word length
  2940.         %s == current number of stop bits
  2941.         %L == latest logfile name
  2942.         %D == latest downloaded file name
  2943.         %U == latest uploaded file name
  2944.         %? == user input string
  2945.               Optional syntaxes:
  2946.                 %?[s1]    uses "s1" as prompt for input, no default value
  2947.                 %?[s1%s2] uses "s1" as prompt for input,
  2948.                           "s2" as default value
  2949.                 %?[%s1]   uses the default prompt, "s1" as default value
  2950.         %% == percent sign
  2951.         anything else following '%' is itself
  2952.  
  2953.   Example Entries:
  2954.  
  2955.         0x0011,1
  2956.         External Download Protocol
  2957.         xdl.exe
  2958.         -H%h -B%b -r %?[Enter download filename:]
  2959.  
  2960.     The above example will present the user with a dialog box which
  2961.   will prompt "Enter download filename:" and allow entry of a string of
  2962.   up to 126 characters.  OS/2 will search the PATH for xdl.exe and,
  2963.   assuming that the port handle is 7, baud rate is 9600, and the user
  2964.   entered "foo.zip" in response to the dialog, xdl.exe will receive the
  2965.   command line "-H7 -B9600 -r foo.zip".  Xdl.exe will be executed as a
  2966.   child process of TE/2 in the foreground, TE/2's screen will be saved
  2967.   before and restored after xdl's execution.
  2968.  
  2969.         0x0121
  2970.         Format Disk(s)
  2971.         c:/os2/bin/format.exe
  2972.         %?[Format parameters:%a: /4]
  2973.  
  2974.     The above example will again present the user with a dialog box
  2975.   which will prompt "Format parameters:" and allow entry of a string of
  2976.   up to 126 characters.  The default value of the input will be "a: /4"
  2977.   which may be accepted with a carriage return, edited, or replaced.
  2978.   c:/os2/bin/format.exe will be executed (if it exists) in its own
  2979.   session - either full screen or in a VIO window depending on whether
  2980.   you've marked format.exe as windowcompat.  The session will come up
  2981.   in the foreground but you may switch back to TE/2 by normal means at
  2982.   any time.  The session is a child session of TE/2 however, you will
  2983.   be returned to TE/2 when the session closes.
  2984.  
  2985.   The supplied TE2.XEX file contains eight more examples.
  2986.  
  2987.     NOTE: You may have multiple external program files.  Type 'N' while
  2988.   the External Program menu is up and you will be prompted for a new
  2989.   file.  This directive does NOT appear on the menu yet, you just have
  2990.   to know about it.
  2991.  
  2992.     CAUTION: Don't execute a FOREGROUND, DosExecPgm type process when
  2993.   you have massive amounts of incoming data at the comm port!  The comm
  2994.   and kbd handlers are disabled during the exec call; the call will
  2995.   return immediately from any background and/or session process but not
  2996.   from a foreground exec.  This could result in buffer overflows and
  2997.   loss of data.
  2998.  
  2999.  
  3000.  
  3001.       E. TE2.FNK
  3002.  
  3003.     You can define strings for the forty-eight function keys (F1-F12,
  3004.   shifted, control, and alt) via ALT-K. By default, these are read from
  3005.   the file TE2.FNK but key definitions may be saved to and read from
  3006.   other file names as well.
  3007.  
  3008.     Some special characters are recognized in these strings: '^' as a
  3009.   control code prefix (i.e., "^M" for carriage return, "^[" for ESCape,
  3010.   use "^!" to send the literal "^" character), and '~' to indicate a 1/2
  3011.   second pause when transmitting the string.
  3012.  
  3013.     Please refer to the notes in the section above which discusses
  3014.   redefining function keys via the Alt-K menu as it relates to the
  3015.   usage certain function keys by the VT100 and IBM 3101 emulations.
  3016.  
  3017.  
  3018.       F. TE2INP.XLT and TE2OUT.XLT
  3019.  
  3020.     TE/2 uses these two file to translate character by character
  3021.   bytes received and bytes transmitted respectively.  Each of these
  3022.   files is 256 bytes long and contains, for each of the 256 possible
  3023.   ASCII characters the ASCII character for the translation.  As
  3024.   supplied, these files will simply translate each character to
  3025.   itself.  The registered version of TE/2 includes an editor for
  3026.   manipulating these files.  Alternately, you may alter these files
  3027.   with a byte-oriented editor or rewrite them completely with a
  3028.   small program written in a high level language.
  3029.  
  3030.     If you do change these files, care should be taken in your choice
  3031.   of translations; especially concerning the translation of control
  3032.   characters (like carriage return or linefeed!) and with any
  3033.   character which may be used in an ANSI or 3101 command sequence by
  3034.   the terminal emulator (i.e., if you translate "m" then the ANSI
  3035.   "ESC [ 0 m" sequence to reset the color attribute will cease to
  3036.   function properly!).
  3037.  
  3038.     Any character translated to zero in TE2INP.XLT will effectively
  3039.   block that character from display or any other further translation
  3040.   by TE/2 or the terminal emulation packages.  Because it is possible
  3041.   to transmit an ASCII zero (via Control-@ or other methods), this
  3042.   situation does not occur in TE2OUT.XLT.
  3043.  
  3044.  
  3045.   -------------------------------------------------------------
  3046.  
  3047.  
  3048. IX. Registering TE/2
  3049.  
  3050.  
  3051.   A. Why Register?
  3052.  
  3053.     If you find that you like TE/2 and desire to continue using it,
  3054.   you should become a registered user.  Registration confers on you
  3055.   a number of benefits:
  3056.  
  3057.     o  You will receive the full featured version of TE/2 which
  3058.        contains TE/2's very powerful script language.  You can use
  3059.        TE/2 scripts for automating logon procedures to all of the
  3060.        bulletin boards and services you routinely call.  You can
  3061.        program a TE/2 host mode through the script language creating
  3062.        a mini-BBS.  TE/2's script language is actually robust
  3063.        enough that you may be tempted to do any number of programming
  3064.        chores that you would normally need a 'real language' to do.
  3065.        A very complete documentation file for the TE/2 script
  3066.        language is included with this package and you are urged to
  3067.        read it through.  We'll just point out a couple of major
  3068.        features here:
  3069.  
  3070.        -  A full range of conditional and control statements:
  3071.           IF-ELSE-ENDIF blocks with ELSEIF, DO WHILE, DO UNTIL,
  3072.           BREAK and CONTINUE statements.  True subroutines.
  3073.  
  3074.        -  User definable dynamic string and 32 bit integer variables,
  3075.           as many as you'll need.  Variables may be local to the
  3076.           script file or global and shared between script files.
  3077.  
  3078.        -  Complete set of file handling functions for opening,
  3079.           closing, reading, writing any number of files.
  3080.  
  3081.        -  Asynchronous event watches that can launch another script
  3082.           or just toggle a variable.
  3083.  
  3084.        -  Low and high level interface into nearly all of TE/2's
  3085.           functionality.
  3086.  
  3087.        -  A command line interface for executing single statements.
  3088.  
  3089.  
  3090.  
  3091.     o  The registered version of TE/2 contains the CompuServe B+
  3092.        protocol and an enhanced ZModem which includes the ability to
  3093.        fine tune several internal ZModem settings and the ability to
  3094.        resume aborted downloads.
  3095.  
  3096.     o  You will also receive full printed documentation for TE/2.
  3097.  
  3098.  
  3099.     o  You are automatically registered for the next version of TE/2
  3100.        when it becomes available.  You will be notified of all new
  3101.        releases thereafter as they happen.
  3102.  
  3103.  
  3104.     o  Registered users will receive priority service on technical
  3105.        assistance through the Oberon Software User Support BBS. 
  3106.        Anyone and everyone may call the BBS with questions however.
  3107.  
  3108.  
  3109.     o  Plus, you get the piece of mind to know that you have helped
  3110.        support the shareware concept which is dedicated to bringing
  3111.        quality software at low prices to as many people as possible.
  3112.        Shareware authors devote many, many hours of their time
  3113.        creating their products.  If people register the shareware
  3114.        programs they use, this will send a message to those talented
  3115.        programmers that a noble cause can be a viable way of life!
  3116.  
  3117.  
  3118.   B. How to Register
  3119.  
  3120.     Refer to the accompanying file ORDER.FRM for a sample order form.
  3121.   Pricing information is contained in that file also.  If, for any
  3122.   reason, that file is unavailable to you, please write or call:
  3123.  
  3124.                         Oberon Software
  3125.                         518 Blue Earth St.
  3126.                         Mankato, MN  56001
  3127.                         507-388-7001 (voice)
  3128.  
  3129.     For quantity orders, please contact Oberon Software for quantity
  3130.   discounts.
  3131.  
  3132.     For use by corporations and other institutions, please  contact
  3133.   the Oberon Software for a licensing arrangement.
  3134.  
  3135.   -------------------------------------------------------------
  3136.  
  3137.  
  3138. X.  Disclaimer
  3139.  
  3140.     Every care has been taken so that TE/2 will perform as outlined in
  3141.   this document and that it is as error free as the author can make it.
  3142.   We should be aware however that no piece of software is ever totally
  3143.   bug free.
  3144.  
  3145.     Use of this software for any purpose whatsoever constitutes your
  3146.   unqualified acceptance of the following statements.
  3147.  
  3148.     The author makes no warranty or representation that the software will
  3149.   be error free.  The author disclaims any warranties, either express or
  3150.   implied, including but not limited to any implied warranty of
  3151.   merchantability or fitness for any particular purpose.
  3152.  
  3153.     The user agrees to take full responsibility for the selection of and
  3154.   any use whatsoever made of the software.
  3155.  
  3156.  
  3157.       IN NO EVENT WILL THE AUTHOR BE LIABLE FOR ANY DAMAGES WHATSOEVER
  3158.     (INCLUDING WITHOUT LIMITATION DAMAGES FOR LOSS OF BUSINESS PROFITS,
  3159.     BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION OR THE LIKE)
  3160.     ARISING OUT OF THE USE OF, INTERRUPTION IN THE USE OF, OR INABILITY
  3161.     TO USE THIS SOFTWARE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF ANY
  3162.     POSSIBILITY OR LIKELIHOOD OF SUCH DAMAGES.
  3163.  
  3164.  
  3165.       ________________________________________________________________
  3166.  
  3167.  
  3168.     "IBM", "IBM PC/AT", "PS/2", "IBM OS/2" are all registered trademarks
  3169.   of and copyright by International Business Machines.
  3170.     "Microsoft", "Microsoft Windows", "MS OS/2" are all registered
  3171.   trademarks of and copyright by the Microsoft Corporation.
  3172.     "Procomm" is a registered trademark of DataStorm Technologies.
  3173.     "VT100" is a registered trademark of Digital Equipment
  3174.   Corporation.
  3175.     "Hayes" is a registered trademark of Hayes Microcomputer
  3176.   Products.
  3177.     "GEnie" is a registered trademark of the General Electric
  3178.   Corporation.
  3179.     "MCI Mail" is a registered trademark of MCI Communications
  3180.   Corporation.
  3181.     "CompuServe" is a registered trademark of CompuServe Information
  3182.   Service.
  3183.  
  3184.       ________________________________________________________________
  3185.  
  3186.  
  3187.                          Oberon Software
  3188.                          518 Blue Earth Street
  3189.                          Mankato  MN 56001
  3190.  
  3191.                          Voice phone: 507/388-7001
  3192.                          Bulletin Board: 507/388-1154
  3193.                          FAX: 507/388-3099
  3194.                          MCI Mail address: oberon/413-5847
  3195.                          GEnie Mail address: B.FLOWERS
  3196.                          CompuServe ID: 72510,3500
  3197.  
  3198.  
  3199.